███████╗███╗ ███╗ █████╗ ██████╗ ████████╗ ██████╗██╗ ██╗
██╔════╝████╗ ████║██╔══██╗██╔══██╗╚══██╔══╝ ██╔════╝██║ ██║
███████╗██╔████╔██║███████║██████╔╝ ██║ ██║ ██║ ██║
╚════██║██║╚██╔╝██║██╔══██║██╔══██╗ ██║ ██║ ██║ ██║
███████║██║ ╚═╝ ██║██║ ██║██║ ██║ ██║ ╚██████╗███████╗██║
╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝ ╚═════╝╚══════╝╚═╝
$ smart "Design a microservices architecture with authentication"
🤖 Analyzing task... Routing to Claude Code (best for planning)
📋 Generating architecture diagram...
✨ Created: docs/architecture.md, docker-compose.yml, auth-service/
⚡ Time: 3.2s | Agent: Claude Code | Success: ✅Smart CLI is a revolutionary command-line environment that intelligently orchestrates multiple AI agents (Claude Code, Gemini, Codex, Grok) to provide the optimal assistant for any task. Combined with complete TUI integration, smart shell features, and 20+ MCP servers, it creates the ultimate developer experience.
- 🤖 Multi-Agent Intelligence - Automatically routes tasks to the best AI agent
- ⚡ 4 AI Agents - Claude Code (planning), Gemini (1M context), Codex (code gen), Grok (speed)
- 🔧 20+ MCP Servers - Docker, GitHub, AWS, Apple ecosystem, audio/video tools
- ⌨️ AI-Powered Shell - Smart completions, suggestions, and safety hooks
- 🖥️ Complete TUI Integration - 24+ terminal apps seamlessly integrated
- 🔄 Multi-Agent Workflows - Chain agents for complex tasks (code review, debugging, project setup)
- 🔐 Security First - Encrypted API keys, safe mode, destructive command protection
# Smart CLI analyzes your task and selects the optimal agent
smart "Design a microservices architecture" # → Claude Code (planning)
smart "Implement user authentication" # → Codex (code generation)
smart "Analyze entire codebase for security" # → Gemini (large context)
smart "Quick bug fix in utils.py" # → Grok (speed)Agent Selection Matrix:
| Agent | Context | Best For | Speed |
|---|---|---|---|
| Claude Code | 200K | Planning, architecture, code review | ⚡⚡⚡ |
| Gemini CLI | 1M | Large codebases, full analysis | ⚡⚡ |
| Codex | 128K | Code generation, implementation | ⚡⚡⚡⚡ |
| Grok | 128K | Quick tasks, fast iterations | ⚡⚡⚡⚡⚡ |
Keyboard Shortcuts:
Ctrl+X Ctrl+E- AI command completionCtrl+X Ctrl+S- Switch AI agent on the flyCtrl+X Ctrl+A- Smart command suggestionsCtrl+X Ctrl+F- Launch TUI file browserCtrl+X Ctrl+T- Tmux session manager
Smart Features:
- Pre-execution safety checks for destructive commands
- Post-execution error analysis with AI fix suggestions
- Intelligent command history with AI ranking
- Context-aware completions
20+ Model Context Protocol servers for extended capabilities:
Infrastructure:
- Docker - Container management
- GitHub - Repository operations
- AWS - Cloud infrastructure
Apple Ecosystem:
- Contacts, Notes, Mail, Calendar, Messages, Reminders, Maps
Audio/Video:
- Ableton, Reaper, Spotify (music production)
- FFmpeg, yt-dlp (video processing)
Development:
- Filesystem, Git, Fetch, Memory, Sequential-thinking
Execute complex multi-step tasks with coordinated agents:
# Code Review Workflow
smart --workflow=code_review
# 1. Claude analyzes changes
# 2. Codex performs security scan
# 3. Gemini reviews performance
# 4. Claude generates summary report
# Project Setup Workflow
smart --workflow=project_setup
# Creates structure, dependencies, Docker, CI/CD, git, docs
# Debug Session Workflow
smart --workflow=debug_session
# Analyzes error → Reproduces → Identifies cause → Proposes fix → Creates tests24+ terminal UI applications integrated:
| Category | Tools |
|---|---|
| Files | yazi, ranger, nnn |
| Git | lazygit, tig |
| Docker | lazydocker, dive |
| System | glances, btop, htop |
| Music | ncmpcpp, cmus, mopidy |
| Modern Unix | bat, ripgrep, fd, exa, delta |
- Encrypted API Keys - age encryption with session-scoped decryption
- Safe Mode - Confirmation for destructive commands (
rm -rf,git push --force) - Autonomous Safeguards - User approval required for critical operations
- Private by Default - No telemetry, all processing local
- macOS 26.3+ or Linux
- Python 3.13+
- Node.js 22+
- Zsh (recommended)
# Clone the repository
git clone https://github.com/sm3222/Terminal.git
cd Terminal
# Run the installation script
./install.sh
# Or manual installation:
cp -r .smart-cli-env ~/.smart-cli
~/.smart-cli/bin/setup-encryption.sh # Encrypt API keys
cat ~/.smart-cli/zshrc-integration.sh >> ~/.zshrc
exec zsh-
Encrypt API Keys:
~/.smart-cli/bin/setup-encryption.sh -
Configure Shell:
cat ~/.smart-cli/zshrc-integration.sh >> ~/.zshrc exec zsh
-
Test Installation:
smart --list-agents smart "Design a REST API" --dry-run smart --list-workflows
# List available agents
smart --list-agents
# Test agent selection (dry-run mode)
smart "Create a Python web scraper" --dry-run
# Force specific agent
smart "Implement auth" --agent=codex
# Execute workflow
smart --workflow=code_review
# Use MCP servers
smart "List Docker containers" --mcp=docker
smart "Create GitHub issue" --mcp=github- Setup Guide - Complete installation and configuration
- Developer Guide - Architecture and development
- CLAUDE.md - Repository overview for AI agents
- Workflows - Workflow definitions
- Configuration - Agent and routing configuration
┌─────────────────────────────────────────┐
│ CLI Interface (smart.py) │ ← User entry point
│ - Argument parsing │
│ - Command routing │
└─────────────────────────────────────────┘
↓
┌─────────────────────────────────────────┐
│ Orchestration Layer │
│ ├─ AgentSelector (selector.py) │ ← Task analysis & routing
│ ├─ TaskRouter (router.py) │ ← Agent execution
│ └─ ContextManager (context.py) │ ← Multi-agent context
└─────────────────────────────────────────┘
↓
┌─────────────────────────────────────────┐
│ Agents (subprocess calls) │
│ ├─ claude (Primary - planning) │
│ ├─ gemini (1M context) │
│ ├─ codex (Code generation) │
│ └─ grok (Speed) │
└─────────────────────────────────────────┘
Edit ~/.smart-cli/config.yaml to customize:
agents:
primary: claude-code
routing:
rules:
- condition: "context_size > 100000"
agent: gemini
- condition: "task_type == 'code_generation'"
agent: codex
default: claude-code
autonomous:
enabled: false
confirmation_required: [file_deletion, git_force_push, production_deploy]We welcome contributions! Please see CONTRIBUTING.md for guidelines.
# Clone the repository
git clone https://github.com/sm3222/Terminal.git
cd Terminal
# Install development dependencies
pip install -e ".[dev]"
# Run tests
pytest tests/
# Format code
black .Multi-agent code review with security scanning and performance analysis.
Automated project initialization with structure, dependencies, Docker, CI/CD, and documentation.
AI-assisted debugging from error analysis to fix proposal with tests.
- Add more AI agents (DeepSeek, Anthropic Haiku, OpenAI o1)
- Parallel workflow execution
- Advanced context passing between agents
- Response caching and optimization
- Web dashboard for monitoring
- Agent performance analytics
- Custom workflow builder UI
- Integration with VS Code/Cursor
- Homebrew formula for easy installation
Smart CLI is 100% free and open source, built with passion and countless hours of development. If this project saves you time, makes you more productive, or just makes you smile, consider supporting its continued development!
|
Free and helps visibility! 
|
Recurring or one-time 
|
Buy me a coffee! 
|
Monthly support tiers 
|
| Tier | Monthly | Perks |
|---|---|---|
| 🌱 Supporter | $5 | • Sponsor badge on your profile • Name in README • My eternal gratitude |
| 🚀 Pro | $25 | • All Supporter perks • Early access to new features • Priority bug fixes • Direct Discord access |
| 💎 Enterprise | $100 | • All Pro perks • 1-on-1 support calls • Custom feature requests • Your logo in README |
| 🏆 Platinum | $500 | • Everything above • Dedicated support channel • Custom workflow development • Co-marketing opportunities |
Become the first sponsor! Your support directly funds:
- 🔧 New features and improvements
- 🐛 Bug fixes and maintenance
- 📚 Documentation and tutorials
- 🎥 Video guides and demos
- 🌐 Community support
Not ready for monthly? No problem!
| Goal | Amount | Status |
|---|---|---|
| 🎯 Cover hosting costs | $50/mo |  |
| 🚀 Dedicated development time | $500/mo |  |
| 💼 Full-time development | $3000/mo |  |
"This is the terminal environment I've been dreaming of! The multi-agent routing is pure genius." — Developer @ FAANG
"Smart CLI cut my development time in half. The AI integration is seamless." — Startup Founder
"Finally, a CLI tool that understands context and routes to the right AI. Game changer!" — DevOps Engineer
Project Statistics:
- 📦 4 AI Agents integrated
- 🔧 20+ MCP Servers available
- 🖥️ 24+ TUI Apps included
- ⭐ Growing community of developers
- 🔥 Active development since 2025
- 🎖️ Early Adopters - Thank you for believing in this project!
- 💡 Feature Requesters - Your ideas shape the future
- 🐛 Bug Reporters - Helping make Smart CLI rock solid
Join the Community!
- 🐛 Issues: Report bugs
- 💬 Discussions: Ask questions
- 📝 Changelog: See what's new
- 🎮 Discord: Chat with us
This project is licensed under the MIT License - see the LICENSE file for details.
TL;DR: You can do whatever you want with this code. Just don't sue me if something breaks! 😄
Built With Love Using:
Inspired By:
- The amazing CLI/TUI community 🎨
- Every developer who loves the terminal 💻
- You, for checking this out! 🙏
Built with mind over matter by @sm3222
Pushing to AGI with every line of code.
Made with 🧠 and ☕ by @sm3222 Part of WEBServices-ORG
© 2025 Smart CLI • MIT License
