# CLI Reference
All commands available in the sitter CLI.
## Work Item Commands
sitter create
Create a new work item with a title and optional spec/context.
sitter create --title <title> [flags]
| Flag | Description |
|---|---|
--title | Title of the work item (required) |
--context | Spec/description. Use @filename for file, - for stdin |
--tags | Comma-separated tags (e.g. bug,urgent,v2) |
--repo | Target repository (owner/name format) |
--blocked-by | ID of work item that blocks this one (repeatable) |
--auto-start | Auto-start when all blockers complete |
Examples:
sitter list
List all work items, optionally filtered by status or tags.
sitter list [flags]
| Flag | Description |
|---|---|
--status | Filter by status (defined, queued, in_progress, in_review, done, blocked, waiting) |
--tag | Filter by tag (repeatable, AND logic) |
--tags | Filter by comma-separated tags (AND logic) |
--all | Include completed (done) work items |
Examples:
sitter status
Show detailed status of a specific work item, including activity timeline and agent info.
sitter status <id>
sitter start
Start a coding agent on a work item. The agent runs in an isolated git worktree.
sitter start <id>
sitter stop
Stop a running agent on a work item.
sitter stop <id>
sitter delete
Delete a work item and clean up its worktree.
sitter delete <id>
sitter logs
View agent logs for a work item. Use -f to follow in real time.
sitter logs <id> [flags]
| Flag | Description |
|---|---|
-f, --follow | Follow log output (like tail -f) |
Examples:
sitter update
Update fields on an existing work item.
sitter update <id> [flags]
| Flag | Description |
|---|---|
--title | New title |
--context | New context/spec. Use @filename for file, - for stdin |
--status | New status (defined, in_progress, in_review, done, blocked) |
--tags | Replace tags (comma-separated) |
Examples:
sitter tag
Add one or more tags to a work item.
sitter tag <id> <tag1> [tag2] ...
sitter untag
Remove one or more tags from a work item.
sitter untag <id> <tag1> [tag2] ...
sitter push
Manually push changes and create a PR for a work item. Requires GitHub App to be configured.
sitter push --work-id <id>
| Flag | Description |
|---|---|
--work-id | Work item ID (required) |
## Configuration Commands
sitter config
Manage agent profiles (coding, review). View or update CLI, model, and prompt settings per agent type.
sitter config agents [name] [flags]
Examples:
## Server Commands
sitter serve
Start the API server and dashboard.
sitter serve [flags]
| Flag | Description | Default |
|---|---|---|
--port | Port to listen on | 51773 |
sitter install
Install sitter as a systemd service. Linux only, requires sudo.
sudo sitter install [flags]
| Flag | Description | Default |
|---|---|---|
--port | Port to run the service on | 51773 |
--user | User to run the service as | auto-detected |
sitter uninstall
Remove the sitter systemd service.
sudo sitter uninstall
sitter restart
Restart the sitter systemd service.
sitter restart [flags]
| Flag | Description |
|---|---|
--force | Force restart even if agents are running |
sitter upgrade
Pull the latest version, rebuild, and restart.
sitter upgrade [flags]
| Flag | Description |
|---|---|
--check | Check for updates without applying |
--force | Force upgrade even if agents are running |
## GitHub Commands
sitter repos
List repositories accessible to the configured GitHub App.
sitter repos
sitter setup
Configure GitHub App authentication for automated PR creation.
sitter setup github-app
## Other
sitter version
Show the installed version of sitter.
sitter version