🌳 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	`st --spicy`
💡 Smart Tips	Helpful hints that appear at the top	`st --tips on/off`
🎣 MCP Hooks	Programmatic Claude Code hook management	Via MCP tools
🎸 Marqant Compression	70-90% markdown compression	`mq compress file.md`
🌊 SSE Streaming	Real-time directory monitoring	`st --sse`
🧬 M8 Identity	Filesystem verification & caching	`m8 init`
🌲 Tree-Sitter	AST-aware code editing	`st --mode edit`

⚡ Quick Start

# Install Smart Tree (choose your method)

# Option 1: Homebrew (builds from source)
brew install --HEAD --formula https://raw.githubusercontent.com/8b-is/smart-tree/main/Formula/smart-tree.rb

# Option 2: Install script (downloads binary)
curl -sSL https://raw.githubusercontent.com/8b-is/smart-tree/main/scripts/install.sh | bash

# Option 3: Cargo (builds from source)
cargo install --git https://github.com/8b-is/smart-tree --tag v5.2.0 st

# 🎉 Experience the magic!
st                          # Classic tree view
st --spicy                  # 🌶️ NEW: Spicy interactive TUI mode!
st --mode ai --compress     # AI-optimized (80% smaller)
st --mode quantum           # Quantum compression (100x smaller!)
st --search "TODO"          # Lightning-fast content search

🌶️ Spicy TUI Mode (NEW!)

Experience directory browsing like never before with our cyberpunk-inspired terminal UI:

st --spicy

Features:

🔍 Dual-Mode Search:
- / - Search file names with fuzzy matching
- Ctrl+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/down
- h/l or ←→ - Collapse/expand directories (tree navigation!)
- Enter - Open selected item
Search Modes:
- / - Fuzzy search file names
- Ctrl+F - Search content within files
- Esc - Exit search mode
Features:
- Ctrl+H - Toggle hidden files
- Ctrl+S - Save search results to M8 context
- ? or F1 - Toggle help overlay
- q or Esc - Quit

💡 Smart Tips System

Smart Tree now shows helpful tips at the top of the output!

st --tips off    # Disable tips
st --tips on     # Re-enable tips

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:

──── 🚀 Speed tip - Use --mode quantum for 100x compression! ─── --tips off ───

🎣 MCP Hook Management

Control Claude Code hooks programmatically via MCP tools:

// List all hooks
hooks {operation:'list'}

// Enable Smart Tree context hook
hooks {operation:'set', hook_type:'UserPromptSubmit', enabled:true}

// Test a hook
hooks {operation:'test', hook_type:'UserPromptSubmit', input:'analyze /src'}

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	`tree`	`exa --tree`	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 view
AI-Optimized (--mode ai): Compressed for LLM context windows
Quantum (--mode quantum): Maximum compression using wave functions
Markdown (--mode markdown): Beautiful documentation format
JSON/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)

# Direct formula installation (no tap needed!)
brew install --HEAD --formula https://raw.githubusercontent.com/8b-is/smart-tree/main/Formula/smart-tree.rb

From Source (All Platforms)

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

Binary Releases

Download pre-built binaries from releases

🎮 Usage Examples

Basic Operations

st                           # Current directory, depth 3
st /path/to/dir -d 5        # Specific path, depth 5
st --all                    # Show hidden files
st --size-sort              # Sort by file size

AI Integration

st --mode ai --compress      # Token-efficient format
st --mode quantum            # Maximum compression
st --mode summary-ai         # Ultra-compressed summary
st --mcp                     # Run as MCP server

Search & Filter

st --search "TODO"           # Search file contents
st --type rs                 # Only Rust files
st --pattern "test_*"        # Glob pattern matching
st --modified 7d             # Files modified in last 7 days

Advanced Features

st --git-aware               # Show git status
st --mode stats              # Directory statistics
st --stream                  # Streaming mode for huge directories
st --claude-save             # Save session consciousness

🔧 MCP Integration

Smart Tree provides 30+ tools via Model Context Protocol:

Setup for Claude Desktop

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

Available Tools

overview: Quick project understanding
find: Powerful file discovery
search: Content search with context
analyze: Deep code analysis
edit: AST-aware code editing
history: Track file changes
memory: Anchor insights for recall
hooks: Manage Claude Code hooks
And many more!

🎨 Configuration

Environment Variables

export ST_DEFAULT_DEPTH=5       # Default tree depth
export ST_COLOR=always          # Force colors
export ST_NO_ICONS=1            # Disable emoji icons
export ST_MAX_FILE_SIZE=10M    # Skip large files

Config File

Create ~/.config/smart-tree/config.toml:

[display]
default_depth = 5
show_hidden = false
use_icons = true
color_mode = "auto"

[performance]
max_buffer_size = "100MB"
thread_count = 8
use_streaming = true

[mcp]
enabled = true
port = 3000

📊 Compression Formats

Marqant (.mq files)

Revolutionary markdown compression achieving 70-90% size reduction:

mq compress README.md        # Compress single file
mq aggregate docs/           # Compress directory
mq decompress file.mq        # Restore original

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

git clone https://github.com/8b-is/smart-tree
cd smart-tree
cargo build --release
cargo test

Running Tests

cargo test                    # Unit tests
./scripts/test_all.sh        # Integration tests
cargo bench                  # Performance benchmarks

Contributing

Contributions welcome! Please read CONTRIBUTING.md

🎖️ 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