capsule-ai-cli

Capsule CLI - All in one AI CLI

Capsule is a powerful command-line interface that orchestrates multiple AI models intelligently, enabling complex workflows and optimal results across various AI providers.

✨ Features

🤖 Multi-Model Support

• Capsule is built on top of OpenRouter, so it can use any model that is available on OpenRouter. Currently, there are 400+ models available with 60+ providers.

🎯 Intelligent Modes

• Agent Mode: Direct task execution with full tool access
• Plan Mode: Strategic planning before implementation
• Orchestrator Mode: Automatic delegation to specialized sub-agents
• Auto Mode: Let Capsule work on a feature independently (Dangerous)

🛠️ Built-in Tools

• File Operations: Read, write, edit files with smart confirmations
• Terminal Commands: Execute bash commands safely
• Web Tools: Search Google, fetch web content
• Git Integration: Version control operations
• Todo Management: Track tasks within conversations
• Sub-Agent Spawning: Parallel task execution

Installation

npm install -g capsule-ai-cli

Activation

After installation, activate Capsule with your activation code:

capsule activate CAPS-XXXX-XXXX-XXXX

# Or use the interactive menu
capsule
/activate

Purchase activation codes at https://capsulecli.dev

🚀 Quick Start

# Start Capsule
capsule

# Resume your last conversation
capsule --resume

📝 Commands

Chat Management

• /new - Start a new chat session
• /clear - Clear the screen
• /delete - Delete a previous chat
• /exit - Exit Capsule

AI Configuration

• /model - Switch AI model
• /provider - Switch AI provider
• /keys - Configure API keys
• /orchestrator - Configure orchestrator preferences

Analytics

• /context - Show context statistics
• /compact - Compact conversation history
• /stats - Show usage statistics
• /cost - Show cost summary

Other

• /activate - Activate your license
• /benchmark - Benchmark model performance
• /help - Show all commands

⌨️ Keyboard Shortcuts

• Shift+Tab - Switch between modes
• Ctrl+C - Exit
• ↑↓ - Navigate through history
• Tab - Autocomplete commands
• Esc - Cancel current operation

🔧 Configuration

Capsule stores configuration and chat history in:

• macOS/Linux: ~/.config/capsule/

API Key Setup

# Configure API keys through the interactive menu
capsule
/keys

📋 Requirements

• Node.js 18.0.0 or higher
• Active internet connection
• Valid activation code (for full features)
• API keys for your preferred providers

🐛 Troubleshooting

Common Issues

"Command not found" after installation

# Try running with npx
npx capsule-ai-cli

# Or check your npm global path
npm config get prefix

"Invalid activation code"

• Ensure you're using the code on the same device
• Codes are single-device only
• Contact support if issues persist

📚 Support

• Documentation: https://capsulecli.dev/docs
• Email: [e-mail]

Built with ❤️ by kodenark