npm package: @heysalad/cheri-cli
Description: Cheri CLI - AI-powered cloud IDE by HeySalad®. With token-tracked sessions, predictable AI costs, and automatic workspace management.
Author: HeySalad
Latest version: 1.3.2

# cheri-cli

CLI for [Cheri](https://cheri.heysalad.app) — 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

```bash
npm install -g @heysalad/cheri-cli
```

Requires Node.js 18+.

## Quick Start

```bash
# 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:

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

## 🔗 Links

- **Homepage**: [cheri.heysalad.app](https://cheri.heysalad.app)
- **NPM Package**: [@heysalad/cheri-cli](https://www.npmjs.com/package/@heysalad/cheri-cli)
- **GitHub**: [Hey-Salad/cheri-cli](https://github.com/Hey-Salad/cheri-cli)
- **Documentation**: See [SETUP_GUIDE.md](./SETUP_GUIDE.md)

## 📝 License

MIT

---

**Built with ❤️ by HeySalad®**