CLI Reference
nimbus
Launch the interactive REPL.
nimbus [--voice]
| Flag | Description |
|---|---|
--voice | Enable voice input mode (requires nimbus-ai[voice]) |
nimbus run
Run a task non-interactively.
nimbus run "<task>" [options]
| Flag | Description |
|---|---|
--agent <name> | Run a built-in agent instead of a task description |
--skill <name> | Apply a skill to the task |
--backend <url> | Use the hosted backend instead of local execution |
--api-key <key> | API key for the hosted backend (or set NIMBUS_API_KEY) |
-y, --yes | Auto-approve all prompts (plan and diff) |
--no-sound | Suppress audio cues for this run |
Examples:
nimbus run "add input validation to /api/users"
nimbus run --agent security-audit
nimbus run --skill add-tests "add tests for the auth module"
nimbus run "add rate limiting" --backend https://api.get-nimbus.com --api-key nim-...
nimbus run "fix the login bug" -y
nimbus review
Review an existing pull request.
nimbus review <pr-url> [--post]
| Flag | Description |
|---|---|
--post | Post the review as a GitHub PR comment |
nimbus issue
Run a task from a GitHub issue URL.
nimbus issue <issue-url> [options]
| Flag | Description |
|---|---|
--token <token> | GitHub token (or set GITHUB_TOKEN) |
-y, --yes | Auto-approve |
--api-key <key> | API key for hosted backend |
nimbus test
Generate tests for a specific file.
nimbus test <file-path> [--repo-id <id>] [--write]
| Flag | Description |
|---|---|
--repo-id <id> | Repo ID (for hosted backend) |
--write | Write the generated tests to disk |
nimbus agents
List built-in agents.
nimbus agents [--category <category>] [--info <name>]
| Flag | Description |
|---|---|
--category <cat> | Filter by category |
--info <name> | Show full details for one agent |
nimbus skills
Manage skills.
# List all skills
nimbus skills list [--backend <url>] [--api-key <key>]
# Create a skill
nimbus skills create \
--name <name> \
--description <desc> \
--prompt <system-prompt-addition> \
[--backend <url>] [--api-key <key>]
nimbus explain
Explain a file or line range.
nimbus explain <file>
nimbus explain <file>:<start>-<end>
Examples:
nimbus explain src/auth/middleware.py
nimbus explain src/auth/middleware.py:45-78
nimbus replay
Replay a recorded task session.
nimbus replay [--speed <n>] [--session-id <id>]
| Flag | Description |
|---|---|
--speed <n> | Playback speed multiplier (default: 1) |
--session-id <id> | Specific session to replay (Unix timestamp ID) |
nimbus watch
Start ambient background file monitoring.
nimbus watch [--stop]
| Flag | Description |
|---|---|
--stop | Stop a running watch process |
nimbus pair
Start per-save suggestion mode.
nimbus pair
No flags. Stop with Ctrl+C.
nimbus memory
Manage per-repo memory.
nimbus memory [--delete <id>] [--repo <path>]
| Flag | Description |
|---|---|
--delete <id> | Delete a memory entry by ID |
--repo <path> | Query memory for a specific repo path |