Documentation
Sweet CLI
A terminal-native AI coding agent. Reads your codebase, edits files, runs commands, and writes tests — same workflow as Claude Code at a fraction of the cost.
What is Sweet?
Sweet is a CLI tool that runs AI-powered engineering tasks directly in your terminal. You give it a goal — fix a bug, add a feature, write tests, refactor a module — and it plans and executes the work against your actual codebase.
- Reads your repo first — navigates project structure and relevant files before touching anything.
- Edits, runs, verifies — writes code, runs commands, and checks its own output.
- Interrupt anytime — hit Ctrl-C to redirect, add context, or review progress mid-run.
- Pay per use — no $100/month subscription; prepaid balance billed at cost.
Quick start
npm install -g @sweet-cli/sweet
sweet login
sweet start "add input validation to the signup form"Need a balance first? Add prepaid credit →
Browse the docs
Common commands
| Command | What it does |
|---|---|
sweet login | Authenticate with your billing account. |
sweet start "task" | Run a task against the current directory. |
sweet resume | Continue the most recent session. |
sweet --list-sessions | Show all previous sessions. |
sweet --work-for 45m start "task" | Run autonomously for up to 45 minutes. |
/todos | View the agent's current task list mid-run. |
/clear | Reset conversation history. |
How billing works
Sweet uses a prepaid balance model. Add funds on billing and usage is deducted based on actual token consumption — no subscription, no markup beyond cost. Start with as little as $5.
Auth is stored locally in
~/.sweet/config.json. Run sweet login any time to refresh.