Skip to main content

REPL Commands

Task execution​

nimbus › add pagination to the /users endpoint

Any input that isn't a recognized command is treated as a task. Nimbus runs it through the full pipeline: index retrieval → planning → approval → implementation → verification → diff approval → commit.

status​

nimbus › status

Displays current repo state:

  repo      github.com/acme/api
  branch    main
  indexed   847 files  ·  last indexed 2m ago
  memory    12 entries
  models    claude-opus-4-6 → plan  ·  claude-sonnet-4-6 → impl

undo​

nimbus › undo

Reverts the last commit created by Nimbus. Equivalent to git revert HEAD. Only works for the most recent Nimbus commit — use git log and git revert manually for older commits.

explain​

Explain a file:

nimbus › explain src/auth/middleware.py

Explain a specific line range:

nimbus › explain src/auth/middleware.py:45-78

Nimbus reads the file, retrieves related context from the index, and produces a plain-English explanation of what the code does and why.

chat​

nimbus › chat

Enter conversational Q&A mode. Ask anything about your codebase — Nimbus retrieves context and responds with [file:line] citations. Multi-turn context is preserved across questions. Type exit to return to the main prompt.

nimbus › search "JWT token validation"

Semantic search over your indexed codebase. Returns scored results with file paths and previews. Also available as a top-level command: nimbus search "query".

diff​

nimbus › diff
nimbus › diff HEAD~3..HEAD

Review a diff using the self-improving reviewer. Pass a revision range, pipe from stdin, or use --staged to review staged changes. Use --exit-code for CI workflows.

install-hooks / uninstall-hooks​

Available as top-level commands only:

nimbus install-hooks      # install git pre-commit hook
nimbus uninstall-hooks    # remove git pre-commit hook

Installs a hook that runs nimbus diff --staged before every commit. Blocks commits with issues above the configured severity threshold. See Pre-commit hooks for configuration.

help​

nimbus › help

Prints a summary of all available commands.

quit / exit / q​

nimbus › quit
nimbus › exit
nimbus › q

All three exit the REPL cleanly.