capsule-ai-cli/README.md

The AI Model Orchestrator - Intelligent multi-model workflows with device-locked licensing

# Capsule CLI - All in one AI CLI

![Version](https://img.shields.io/badge/version-0.1.5-blue.svg)
![License](https://img.shields.io/badge/license-MIT-green.svg)
![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)

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

```bash
npm install -g capsule-ai-cli
```

## Activation

After installation, activate Capsule with your activation code:

```bash
capsule activate CAPS-XXXX-XXXX-XXXX

# Or use the interactive menu
capsule
/activate
```

Purchase activation codes at [https://capsulecli.dev](https://capsulecli.dev)

## 🚀 Quick Start

```bash
# 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
```bash
# 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**
```bash
# 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](https://docs.capsulecli.dev)
- **Email**: konark@arktechllc.net

---

<p align="center">
  Built with ❤️ by kodenark
</p>