Smart Tree - ST

🌳 Smart Tree - Lightning Fast Directory Visualization

Smart Tree is a blazingly fast, AI-friendly directory visualization tool that's 10-24x faster than traditional tree. Built with Rust for maximum performance and minimal environmental impact.

✨ Key Features

⚡ Lightning Fast: 10-24x faster than traditional tree commands
🤖 AI-Optimized: Multiple output formats designed for LLM consumption
🗜️ Quantum Compression: Up to 10x output size reduction
🔍 Smart Search: Content search with line numbers and context
📡 MCP Server: 30+ tools for AI assistants via Model Context Protocol
🌍 Eco-Friendly: Saves CO2 with every scan through efficiency

🚀 Quick Start

# Install Smart Tree
curl -sSL https://raw.githubusercontent.com/8b-is/smart-tree/main/scripts/install.sh | bash

# Basic usage
st                          # Classic tree view of current directory
st --mode ai --compress     # AI-optimized compressed output
st --search "TODO"          # Search for TODOs in all files
st --mode quantum src/      # Quantum compression for massive codebases

📦 Installation Options

Homebrew (macOS/Linux)

brew install --HEAD 8b-is/smart-tree/smart-tree

From Source

git clone https://github.com/8b-is/smart-tree.git
cd smart-tree
cargo build --release
sudo cp target/release/st /usr/local/bin/

For AI Assistants (Claude Desktop)

st --mcp-config >> ~/Library/Application\ Support/Claude/claude_desktop_config.json

🎯 Common Use Cases

For Developers

st --mode classic --depth 3     # Quick project overview
st --search "function" src/     # Find all functions
st --mode stats                 # Project statistics
st --mode git-status            # See git changes in tree

For AI/LLMs

st --mode ai --compress          # Optimized for token efficiency
st --mode quantum-semantic       # Semantic code understanding
st --mode summary-ai             # Ultra-compressed summaries

For Large Codebases

st --stream /huge/project        # Stream output for massive directories
st --mode quantum --compress     # Maximum compression (100x reduction)

📊 Output Formats

Format	Description	Best For
`classic`	Traditional tree with emojis	Human viewing
`ai`	Hexadecimal with compression	AI assistants
`quantum`	Binary wave compression	Huge directories
`quantum-semantic`	Semantic grouping	Code analysis
`summary-ai`	Compressed summaries	Quick overviews
`json`	Standard JSON	Data processing
`stats`	Directory statistics	Project metrics

See TERMINAL_EXAMPLES.md for beautiful output examples!

🛠️ MCP Server (AI Tools)

Smart Tree includes 30+ MCP tools for AI assistants:

# Start MCP server
st --mcp

# List available tools
st --mcp-tools

# Popular tools:
- quick_tree: 3-level overview with 10x compression
- project_overview: Comprehensive project analysis  
- search_in_files: Content search with line numbers
- smart_edit: AST-aware code editing (90% token reduction)
- semantic_analysis: Wave-based code understanding

🌍 Environmental Impact

Every Smart Tree scan saves energy and reduces CO2 emissions:

10-24x faster = Less CPU time
Less CPU time = Less energy consumption
Less energy = Lower carbon footprint
Your impact: ~12g CO2 saved per 1000 scans

📚 Documentation

TERMINAL_EXAMPLES.md - Beautiful terminal output examples
CLAUDE.md - Development guide for AI assistants
docs/ - Additional documentation
scripts/manage.sh - Colorful project management

🤝 Contributing

We welcome contributions! Smart Tree is developed by a unique partnership:

Hue (Human) - Vision and direction
Aye (AI) - Implementation and optimization
Trish (from Accounting) - Keeping us organized with style

📈 Version History

Current version: v4.8.8

Recent improvements:

v4.8.8: Code formatting, linting, and maintenance updates by Claude
v4.8.7: Moved Marqant to Crate
v4.8.4: Automatic version management system
v4.8.3: Fixed MCP schema validation
v4.8.2: Local feedback fallback when API is offline
v4.8.1: Simplified tool requests API

See CHANGELOG.md for full history.

🎉 Fun Facts

Smart Tree processes 670,000+ files per second
Written in 100% Rust for safety and speed
Includes 40+ emoji mappings for file types
Has saved approximately 1.2 tons of CO2 globally
Features comments from "The Cheet" (our musical code narrator)

📄 License

MIT License - See LICENSE for details.

Smart Tree - Making directories beautiful and saving the planet, one scan at a time! 🌳

Developed with ❤️ by the 8b.is team

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Smart Tree MCP cuts storage by up to 95% using quantum-context compression — not just files, but full project histories. Track, compress, and version smarter with zero-bloat ops across Git, FS, and memory.

Related MCP Servers

Repomix
yamadashy
-
security
A
license
-
quality
Repomix MCP Server enables AI models to efficiently analyze codebases by packaging local or remote repositories into optimized single files, with intelligent compression via Tree-sitter to significantly reduce token usage while preserving code structure and essential signatures.
Last updated -
28,004
18,961
MIT License
mcp-server-tree-sitter
wrale
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that provides code analysis capabilities using tree-sitter, designed to give Claude intelligent access to codebases with appropriate context management.
Last updated -
26
157
MIT License
ZIP-MCP
7gugu
A
security
A
license
A
quality
An MCP tool that provides AI with the ability to compress and decompress local files.
Last updated -
4
5
11
MIT License
deep-filesystem-tree
andredezzy
A
security
A
license
A
quality
A Model Context Protocol (MCP) implementation that provides deep filesystem tree visualization and manipulation capabilities. This tool enables efficient navigation and management of complex directory structures, enhancing development workflows with AI-powered file system operations. Compatible with
Last updated -
1
24
9
MIT License

View all related MCP servers