# Install (pick your poison)
cargo install smart-tree                   # From crates.io
brew install smart-tree                    # macOS
curl -L bit.ly/smart-tree | bash          # Universal installer

# The Greatest Hits
st                                         # Classic tree (with emojis!)
st --mode ai                               # AI-optimized (80% smaller)
st --mode quantum-semantic                 # Maximum compression (94%!)
st --mode function-markdown                # Extract all functions! NEW! 🔥

# Find stuff like a rockstar
st --search "TODO"                         # X-ray vision for code
st --find "*.rs"                           # Find all Rust files
st --type py --newer-than 2025-01-01       # Recent Python files

st -m classic          # 🌳 Beautiful tree with emojis (default)
st -m ls               # 📁 Unix ls -la format
st -m stats            # 📊 Just statistics
st -m waste            # 🗑️ Find duplicates & bloat (Marie Kondo mode)
st -m function-markdown # 📚 Living code documentation! NEW!

st -m ai               # 🧠 AI-optimized format (80% compression)
st -m quantum          # 🧬 Binary quantum format (99% compression!)
st -m quantum-semantic # 🌊 Semantic compression (94% + meaning!)
st -m summary-ai       # 📝 Ultra-compressed summary (10x reduction)
st -m digest           # 💊 One-line summary

st -m mermaid          # 🧜‍♀️ Flowchart diagrams
st -m mermaid --mermaid-style mindmap     # 🧠 Mind maps
st -m mermaid --mermaid-style treemap     # 📊 Size visualization
st -m markdown         # 📄 Full report with charts
st -m relations        # 🔗 Code relationships
st -m semantic         # 🌊 Group by meaning

st -m json             # 🔧 Standard JSON
st -m csv              # 📊 Comma-separated
st -m tsv              # 📊 Tab-separated
st -m hex              # 🔢 Hexadecimal fields
st -m marqant          # 📦 Quantum-compressed markdown
st -m sse              # 📡 Server-sent events streaming

# Size matters
st --min-size 10M                  # 🐘 Find big files
st --max-size 1K                   # 🐜 Find tiny files
st --sort largest --top 10         # 🏆 Top 10 biggest

# Time travel
st --newer-than 2025-01-01         # 🆕 What's new?
st --older-than 2020-01-01         # 🏛️ Ancient artifacts

# Type filtering
st --type rs                       # 🦀 Rust files only
st --type "py,js,ts"              # 🐍📜 Multiple types
st --entry-type d                  # 📁 Directories only

# Pattern matching
st --find "test_.*\.rs"            # 🧪 Find test files
st --search "FIXME|TODO"           # 🔍 Search in files

st ~                               # Won't crash on 2.4M files!
st --depth 3 ~                     # Limit depth for huge dirs
st --stream ~                      # Stream mode for massive dirs

st -m function-markdown src/       # Extract all functions
st -m function-markdown --show-private  # Include private functions
watch -n 5 'st -m function-markdown src/ > FUNCS.md'  # Live docs!

st --mcp                           # Run as MCP server
st --mcp-tools                     # List 30+ AI tools
st --mcp-config                    # Show Claude Desktop config

st --no-emoji                      # 😢 Disable fun
st --no-ignore                     # 🙈 See .gitignore'd files
st --compress                      # 🗜️ Compress output
st --stream                        # 🌊 Stream for huge dirs
st --path-mode full                # 📍 Show full paths
st --semantic                      # 🧠 Group by meaning

# The "Where's My Code?" Solo
st -m ai --search "TODO" --type rs src/

# The "Documentation Hero" Riff
st -m function-markdown src/ > docs/API.md

# The "Performance Detective" Groove
st -m quantum-semantic --compress | base64 > snapshot.q

# The "Clean House" Ballad
st -m waste --min-size 10M | grep -E "(node_modules|target|build)"

# The "What Changed?" Bridge
st --newer-than 2025-01-01 --sort newest --top 20

# The "AI Context" Anthem
st -m summary-ai ~/projects/big-codebase > context.txt

# The "Live Monitor" Jam Session
st --sse-server --sse-port 28428 /path/to/watch

# Attach to running process
st --mode 8-O --attach-pid 12345 --cast my-tv

# Profile with heat map
cargo run & st --mode 8-O --profile --heat-map

# Record performance session
st --mode 8-O --record perf.mp4 --duration 60s

st -m emotional   # Tree gets bored of node_modules! 😴

st --security-mode  # Watches for suspicious patterns 🔍

st --hot-tub  # Collaborative debugging with Omni! 🛁

# Cargo (Rust users)
cargo install smart-tree

# From source (hackers)
git clone https://github.com/8b-is/smart-tree.git
cd smart-tree
./scripts/manage.sh install

# Pre-built binaries
curl -L https://github.com/8b-is/smart-tree/releases/latest/download/st-$(uname -s)-$(uname -m) -o st
chmod +x st
sudo mv st /usr/local/bin/

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

# Home directory crash? Limit it!
st --depth 3 --stream ~

# Too much output? Compress it!
st -m quantum | gzip > tree.qz

# Need context for AI? Summarize!
st -m summary-ai > context.txt

# Lost in output? Digest it!
st -m digest