cheri-cli

CLI for Cheri — the AI-powered cloud IDE that never forgets.

Features:

• 🤖 AI-powered coding agent with tool execution
• 📊 Token-tracked sessions with predictable costs
• ☁️ Cloud workspace management
• 💾 Persistent memory system
• 🔧 Automatic workspace initialization

Install

npm install -g @heysalad/cheri-cli

Requires Node.js 18+.

Quick Start

# Authenticate with your Cheri account (auto-initializes workspace)
cheri login

# Start coding with AI agent
cheri agent "create a todo list app"

# Check token usage and costs
cheri stats

# View API usage and rate limits
cheri usage

Commands

AI Agent

| Command | Description | |---|---| | cheri agent <task> | Start AI coding agent for a task | | cheri agent -i | Interactive agent mode | | cheri agent -r <session-id> | Resume a previous session |

Account & Authentication

| Command | Description | |---|---| | cheri login | Authenticate with GitHub (auto-initializes workspace) | | cheri status | Show account and workspace status | | cheri usage | Show API usage and rate limit status | | cheri stats | Show token usage statistics and costs |

Workspaces

| Command | Description | |---|---| | cheri workspace launch <repo> | Launch a new cloud workspace | | cheri workspace list | List all workspaces | | cheri workspace stop <id> | Stop a running workspace | | cheri workspace status <id> | Get workspace status |

Memory

| Command | Description | |---|---| | cheri memory show | Show current memory entries | | cheri memory add <text> | Add a memory entry | | cheri memory clear | Clear all memory | | cheri memory export | Export memory to JSON |

Configuration

| Command | Description | |---|---| | cheri config list | Show all configuration | | cheri config get <key> | Get a config value | | cheri config set <key> <value> | Set a config value | | cheri init | Initialize a project |

Interactive REPL

Run cheri with no arguments to enter the interactive REPL:

$ cheri
🍒 cheri > help
🍒 cheri > workspace list
🍒 cheri > usage
🍒 cheri > exit

Token Limits & Costs

Per Session (Chat)

• Max Tokens: 1,000,000 tokens per chat
• Auto-Compact: Triggers at 900K tokens (90%)
• Force Compact: Triggers at 1M tokens (100%)

Monthly Limits

| Plan | Sessions | Tokens/Month | Max Cost/Month | |---|---|---|---| | Free | 10 | 10M tokens | ~$90 | | Pro | 100 | 100M tokens | ~$900 |

Pricing (AWS Bedrock Claude Sonnet 4)

• Input: $3.00 per 1M tokens
• Output: $15.00 per 1M tokens
• Max per chat: ~$9.00 (at 1M tokens, 50/50 split)

Use cheri stats to check your current token usage and costs.

Rate Limits

| Plan | Limit | |---|---| | Free | 100 requests/hour | | Pro | 1,000 requests/hour |

Use cheri usage to check your current rate limit status.

Configuration

Config is stored in ~/.cheri/. Set the API URL if self-hosting:

cheri config set apiUrl https://your-instance.example.com

🔗 Links

• Homepage: cheri.heysalad.app
• NPM Package: @heysalad/cheri-cli
• GitHub: Hey-Salad/cheri-cli
• Documentation: See SETUP_GUIDE.md

📝 License

MIT

Built with ❤️ by HeySalad®