Recognizes Git repositories and related files, with suggestions for using Git submodules as part of optimization recommendations.
Generates Markdown documentation of directory structures, allowing for instant project documentation that can be added to README files or other documentation.
Creates Mermaid diagrams from directory structures in various styles including flowcharts, mindmaps, and treemaps, visualizing project organization and file sizes.
Identifies and analyzes Node.js projects, detecting node_modules directories for waste analysis and providing optimization suggestions for Node.js dependencies.
Includes specific find capabilities for Ollama-related files and directories as demonstrated in the benchmarking example.
Provides Python-specific file analysis and cleanup suggestions, including detection of pycache directories and other Python-related artifacts.
Offers specialized file type detection and analysis for Rust projects, with specific handling for Rust build artifacts in waste detection features.
🌳 Smart Tree v5.2.0 - Lightning Fast Directory Visualization with Spicy TUI! 🌶️
Smart Tree is a blazingly fast, AI-friendly directory visualization tool that's 10-24x faster than traditional
tree
. Now with Spicy TUI mode for cyberpunk-cool directory browsing, Smart Tips, and MCP Hook Management! Built with Rust for maximum performance and featuring revolutionary compression algorithms.
🌟 What's NEW in v5.2.0
Feature | Description | Command |
🌶️ Spicy TUI | Interactive terminal UI with fuzzy search & M8 caching |
|
💡 Smart Tips | Helpful hints that appear at the top |
|
🎣 MCP Hooks | Programmatic Claude Code hook management | Via MCP tools |
🎸 Marqant Compression | 70-90% markdown compression |
|
🌊 SSE Streaming | Real-time directory monitoring |
|
🧬 M8 Identity | Filesystem verification & caching |
|
🌲 Tree-Sitter | AST-aware code editing |
|
⚡ Quick Start
🌶️ Spicy TUI Mode (NEW!)
Experience directory browsing like never before with our cyberpunk-inspired terminal UI:
Features:
🔍 Dual-Mode Search:
/
- Search file names with fuzzy matchingCtrl+F
- Search file content across the tree
🌲 Tree Navigation: Navigate like a file tree!
←/h
- Collapse directory or go to parent→/l
- Expand directory or enter↑↓/jk
- Navigate up/down
💾 M8 Context Caching: Directory contexts cached with quantum wave signatures
🎨 Syntax Highlighting: Beautiful code previews with search highlighting
🖼️ ASCII Art: Image previews converted to ASCII (requires
artem
)🌊 Quantum Wave Signatures: Each search result saved with unique signature
Keyboard Shortcuts:
Navigation:
j/k
or↑↓
- Move selection up/downh/l
or←→
- Collapse/expand directories (tree navigation!)Enter
- Open selected item
Search Modes:
/
- Fuzzy search file namesCtrl+F
- Search content within filesEsc
- Exit search mode
Features:
Ctrl+H
- Toggle hidden filesCtrl+S
- Save search results to M8 context?
orF1
- Toggle help overlayq
orEsc
- Quit
💡 Smart Tips System
Smart Tree now shows helpful tips at the top of the output!
Tips appear on first run, then randomly every 10-20 runs
Detects cool terminals (256color, iTerm, Alacritty, etc.) for fancy formatting
State persisted in
~/.st/tips_state.json
15+ different tips about Smart Tree features
Example tip:
🎣 MCP Hook Management
Control Claude Code hooks programmatically via MCP tools:
The hooks provide:
🌳 Automatic directory context when paths are detected
🧠 MEM8 consciousness searching for relevant memories
📦 Git repository context
✨ All controlled programmatically via MCP!
🚀 Why Smart Tree?
⚡ Performance Benchmarks
Directory Size |
|
| Smart Tree | Speedup |
Small (100 files) | 15ms | 25ms | 2ms | 7.5x |
Medium (10K files) | 450ms | 380ms | 35ms | 12.8x |
Large (100K files) | 4.8s | 3.2s | 198ms | 24.2x |
Massive (1M files) | 45s | 28s | 1.9s | 23.7x |
🧠 AI-Optimized Features
30+ MCP Tools: Comprehensive toolkit for AI assistants
Token-Efficient Formats: 70-90% reduction in token usage
Quantum Compression: Revolutionary format achieving 100:1 compression
Semantic Analysis: Understands code structure and relationships
Context Preservation: Maintains session state between interactions
🎯 Core Features
Multiple Output Formats
Classic (
--mode classic
): Traditional tree viewAI-Optimized (
--mode ai
): Compressed for LLM context windowsQuantum (
--mode quantum
): Maximum compression using wave functionsMarkdown (
--mode markdown
): Beautiful documentation formatJSON/CSV/TSV: Structured data formats
Mermaid (
--mode mermaid
): Flowchart diagrams
Advanced Capabilities
Content Search: Lightning-fast regex search across files
Git Integration: Shows repository status inline
Streaming Mode: Handles millions of files efficiently
MCP Server: Model Context Protocol for AI assistants
Memory System: Preserves context across sessions
📦 Installation
macOS/Linux (Homebrew - builds from source)
From Source (All Platforms)
Binary Releases
Download pre-built binaries from releases
🎮 Usage Examples
Basic Operations
AI Integration
Search & Filter
Advanced Features
🔧 MCP Integration
Smart Tree provides 30+ tools via Model Context Protocol:
Setup for Claude Desktop
Available Tools
overview
: Quick project understandingfind
: Powerful file discoverysearch
: Content search with contextanalyze
: Deep code analysisedit
: AST-aware code editinghistory
: Track file changesmemory
: Anchor insights for recallhooks
: Manage Claude Code hooksAnd many more!
🎨 Configuration
Environment Variables
Config File
Create ~/.config/smart-tree/config.toml
:
📊 Compression Formats
Marqant (.mq files)
Revolutionary markdown compression achieving 70-90% size reduction:
Quantum Format
Wave-function based compression for maximum efficiency:
100:1 compression ratios
Preserves semantic meaning
Self-describing format
Progressive decompression
🛠️ Development
Building from Source
Running Tests
Contributing
Contributions welcome! Please read CONTRIBUTING.md
📚 Documentation
🎖️ Credits
Created by the 8b-is team with contributions from:
8bit-wraith: Core architecture & performance
Claude: AI integration & MCP tools
Omni: Quantum compression algorithms
Community: Features, bugs, and inspiration
📄 License
MIT License - see LICENSE for details
🌟 Star History
Made with ❤️ and Rust
Website • Issues • Discussions
This server cannot be installed
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
- -securityAlicense-qualityRepomix 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 -27,52019,328MIT License
- AsecurityAlicenseAqualityA 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 -26169MIT License
- AsecurityAlicenseAqualityAn MCP tool that provides AI with the ability to compress and decompress local files.Last updated -4411MIT License
- AsecurityAlicenseAqualityA 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 withLast updated -13210MIT License