CLI reference
This page summarizes top-level flags and subcommands exposed by caretta.
Command shape
When no subcommand is provided, caretta launches the desktop GUI.
Global options
Option | Description | Default |
|---|---|---|
| Select adapter ( |
|
| Pass non-interactive adapter flags and auto-drive two-phase workflows | off |
| Print planned prompts/actions without supported side effects | off |
| Override workflow preset for one invocation | config/default |
| Override selected model for this invocation | adapter/config |
| Opt into a context workspace under | auto-detect |
| Write bundled labels to | off |
Core subcommands
Subcommand | Purpose |
|---|---|
| Launch desktop UI (same as default behavior) |
| Serve the web UI locally |
| List presets or workflows inside a preset |
| Run any workflow from active preset by ID |
| List bundled model IDs for |
Workflow and delivery subcommands
Subcommand | Purpose |
|---|---|
| Run ideation draft |
| Run UXR synthesis draft |
| Run strategic review draft |
| Run roadmap draft |
| Run sprint planning draft |
| Run retrospective draft |
| Run housekeeping draft |
| Run user interview workflow |
| Run a single issue implementation flow |
| Continuously process tracker issues |
| Print pending issue IDs for CI matrix generation |
PR automation subcommands
Subcommand | Purpose |
|---|---|
| Review all open PRs or one PR |
| Run security-oriented review |
| Diagnose/remediate stuck PR state |
| Resolve merge-conflict branch state after sync marker |
| Approve PR when bot thread rules are satisfied |
| Merge approved |
Maintenance subcommands
Subcommand | Purpose |
|---|---|
| Refresh agent files |
| Refresh repository documentation |
Usage examples
Notes on unattended mode
--auto behavior is adapter-aware. caretta passes provider-specific flags that reduce permission prompts and, for supported two-phase flows, synthesizes feedback so draft transitions directly into finalize.