Welcome to scmd¶

AI-powered slash commands for any terminal. Works offline by default.

scmd brings AI superpowers to your command line—offline, private, and fast. Ask questions in plain English, review code with security templates, chat with AI that remembers context. All without API keys or cloud dependencies.

# Just ask what you want to do
scmd /cmd "find files modified today"
# → find . -type f -mtime -1

# Get instant explanations with beautiful formatting
scmd /explain main.go

# Review with professional security templates
scmd /review auth.js --template security-review

# Chat with full context retention
scmd chat
You: How do I set up OAuth2 in Go?
🤖 Assistant: [Detailed explanation...]
You: Show me an example with JWT
🤖 Assistant: [Builds on previous context...]

✨ Key Features¶

🚀 Quick Start¶

🎯 Highlights¶

Beautiful Markdown Output (v0.5.1)¶

AI responses now render with gorgeous markdown formatting, syntax highlighting, and themes:

scmd /explain quicksort.py

# Output includes:
# - Syntax-highlighted code blocks
# - Formatted headers and lists
# - Tables and links
# - Theme detection (dark/light/auto)
# - Plain text when piped

Performance: Lazy-loaded Glamour renderer with < 1µs overhead when disabled.

Interactive Chat Mode (v0.4.0)¶

Multi-turn conversations with full context retention:

scmd chat

You: How do I implement rate limiting in Express?
🤖 [Detailed explanation with code]

You: What about Redis-based rate limiting?
🤖 [Builds on previous context...]

/export  # Save to markdown

Features: Auto-save, searchable history, resume anytime, markdown export.

Professional Templates (v0.4.0)¶

Standardized code reviews with 6 built-in templates:

Create custom templates for your team. Share as YAML files.

Man Page Integration¶

The /cmd command reads system man pages for exact commands:

scmd /cmd "find files modified in last 24 hours"
# → find . -type f -mtime -1

scmd /cmd "list processes sorted by memory"
# → ps aux --sort=-%mem | head -n 20

Detects 60+ common tools. Falls back to general CLI knowledge.

Command Discovery (v0.5.0)¶

100+ community commands now properly discoverable:

# Search commands
scmd repo search git
scmd repo search docker

# Install instantly
scmd repo install official/commit
scmd repo install official/dockerfile

# Use immediately
git diff --staged | scmd /gc

Repository system fixed in v0.5.0 with legacy manifest support and parallel fetching.

📊 Performance¶

Real-World Benchmarks (M1 Mac, 8GB RAM):

Available Models:

All models: 8192 token context, GPU acceleration, 4-bit quantization, function calling.

🛡️ Stability & Reliability¶

Zero Maintenance Design:

• ✅ Auto-starts - Server starts when needed
• ✅ Auto-restarts - Crashes handled gracefully
• ✅ Self-healing - Detects OOM, context mismatches, recovers automatically
• ✅ Clear feedback - Every error includes actionable solutions
• ✅ No manual intervention - Never need server management

Example Error Handling:

❌ Input exceeds available context size

What happened:
  Your input (5502 tokens) exceeds GPU capacity (4096 tokens)

Solutions:
  1. Use CPU mode: export SCMD_CPU_ONLY=1
  2. Split input into smaller files
  3. Use cloud backend: export OPENAI_API_KEY=...

See Stability Architecture for details.

🌟 Use Cases¶

🔧 LLM Backends¶

Backend Priority: llama.cpp (default) → Ollama → OpenAI → Together.ai → Groq

# Use specific backend
scmd -b ollama /explain main.go
scmd -b openai -m gpt-4 /review code.py

# List backends
scmd backends

📚 Documentation¶

🚀 Recent Releases¶

v0.5.1 (2026-01-12)¶

• Fixed: Streaming AI responses now use Glamour markdown renderer
• Beautiful code blocks with syntax highlighting
• Markdown headers, lists, and formatting properly rendered

v0.5.0 (2026-01-12)¶

• Fixed: Repository manifest parsing bug (100+ commands now discoverable)
• Added legacy manifest format support
• Enhanced command discovery UI
• Parallel manifest normalization (10 concurrent requests)

v0.4.3 (2026-01-12)¶

• Added: Beautiful markdown output with Glamour
• Lazy rendering (< 1ns overhead when disabled)
• Syntax highlighting for 40+ languages
• Theme detection and NO_COLOR support

v0.4.2 (2026-01-11)¶

• Added: Template-command integration
• Official commands repository (100+ commands)
• Unified command specification

v0.4.1 (2026-01-11)¶

• Fixed: Replaced CGO-dependent SQLite with pure Go
• Improved cross-platform compatibility

v0.4.0 (2026-01-10)¶

• Added: Interactive conversation mode with SQLite persistence
• Beautiful markdown output with syntax highlighting
• Template/pattern system with 6 built-in templates
• Conversation history management

See Changelog for full history.

🌍 Community¶

• GitHub: sunboylabs/scmd
• Issues: Report bugs or request features
• Discussions: Ask questions and share commands
• Commands Repository: sunboylabs/commands (100+ commands)

📖 What's Next?¶

🆚 Why scmd?¶

📜 License¶

scmd is open source software licensed under the MIT License.

Built with ❤️ using Go • Inspired by the Unix philosophy and modern AI tooling