Smart Tree

🚀 Smart Tree - Lightning Fast Directory Visualization

Smart Tree is a super - fast, AI - friendly directory visualization tool that's 10 - 24 times faster than the traditional tree command. It's built with Rust to offer top - notch performance and minimize environmental impact.

✨ Features

• ⚡ Lightning Fast: It runs 10 - 24 times faster than traditional tree commands.
• 🤖 AI - Optimized: Multiple output formats are designed for easy consumption by LLMs.
• 🗜️ Quantum Compression: It can reduce the output size by up to 10 times.
• 🔍 Smart Search: You can search for content with line numbers and context.
• 📡 MCP Server: There are over 30 tools for AI assistants via the Model Context Protocol.
• 🌍 Eco - Friendly: Each scan saves CO2 through high - efficiency operation.

🚀 Quick Start

Basic Usage

# 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

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

See TERMINAL_EXAMPLES.md for beautiful output examples!

🛠️ MCP Server (AI Tools)

Smart Tree comes with over 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

Each scan of Smart Tree saves energy and reduces CO2 emissions:

• 10 - 24x faster means less CPU time.
• Less CPU time results in less energy consumption.
• Less energy consumption leads to a lower carbon footprint.
• Your impact: approximately 12g of 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 through 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 the full history.

🎉 Fun Facts

• Smart Tree can process over 670,000 files per second.
• It's written in 100% Rust for safety and speed.
• It includes over 40 emoji mappings for file types.
• It has saved approximately 1.2 tons of CO2 globally.
• It features comments from "The Cheet" (our musical code narrator).

📄 License

This project is under the 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