Treeva

A fast, feature-rich directory analyzer for inspecting project structures, codebases, and file metrics

Status

Note

Alpha Release: This is an early alpha release (v0.1.0a1). Core functionality is implemented, but breaking changes may occur in future versions. Bug reports and feedback are welcome!

• Filesystem scanning with exclusion support
• File and dir metadata extraction
• Language detection (40+ languages)
• Multiple output formats
• AST/Tree-sitter-based analysis for deeper code insights
• Custom exclusions support
• Terminal user interface
• AI-powered analysis and recommendations
• CI/CD integration support

Installation

Requirements

• Python 3.14+
• pip or uv

Using uv (Recommended)

git clone https://github.com/sbalghari/treeva.git
cd treeva
uv sync
uv run treeva --help

Using pip

git clone https://github.com/sbalghari/treeva.git
cd treeva
pip install -e .
treeva --help

Contributing

Contributions are welcome! Please feel free to:

• Report bugs via GitHub Issues
• Submit feature requests
• Open pull requests with improvements

License

This project is licensed under the MIT License - see the LICENSE file for details.

Changelog

See CHANGELOG.md for a detailed history of changes and releases.

Acknowledgments

• Built with Typer for CLI
• Styled with Rich for beautiful terminal output
• Powered by Pathspec for pattern matching