Command reference

Every Anvil command, grouped by what it does. For guided walkthroughs of a feature, see its topic page; this is the quick lookup.

Getting Started

• brew install culpur/anvil/anvil — Install via Homebrew (macOS)
• curl -fsSL https://anvilhub.culpur.net/install.sh \| sh — Install via shell script (Linux / macOS)
• anvil --update — Self-update to the latest release without reinstalling
• anvil — Start the interactive REPL in the current directory
• /login — Authenticate with your AI provider (Anthropic OAuth or API key)

Core Commands

• /help — Show all available commands with short descriptions
• /status — Show current session status: active model, token usage, and provider
• /model <name> — Switch AI model mid-session without losing conversation history
  Example: /model gpt-5
• /cost — Display token costs accumulated in the current session
• /clear — Clear conversation history and start fresh in the same session
• /focus — Toggle focus view — show only prompts, tool summaries, and responses (Ctrl+O)
• /fork — Branch the conversation — create, list, or switch between branches
  Example: /fork experiment \| /fork list \| /fork switch 1
• /compact — Compress conversation history to a summary to free context window space
• /version — Show Anvil version, build hash, and build date
• /language <code> — Switch the UI language (en / de / es / fr / ja / zh-CN / ru)
  Example: /language de

File & Code Operations

• /semantic-search — AST-aware symbol search across the project (functions, classes, structs)
  Example: /semantic-search --type function --lang rust authenticate
• /refactor rename <old> <new> — Rename a symbol across all files in the project with conflict detection
  Example: /refactor rename getUserById fetchUserById
• /refactor extract <file> <lines> — Extract a range of lines into a new named function with proper signature inference
  Example: /refactor extract src/auth.ts 42-61
• /diff — Show the current working directory diff with AI-generated change summary

AI-Powered Development

• /test generate <file> — Auto-generate unit tests for a source file using the project's existing test framework
  Example: /test generate src/auth/jwt.ts
• /test run — Run the project test suite — auto-detects Cargo, npm, pytest, and go test
• /test coverage — Generate a test coverage report and highlight uncovered branches
• /review <file> — AI code review of a single file: security issues, logic errors, and style
  Example: /review src/api/auth.ts
• /review staged — Review all staged git changes before committing — catches issues early
• /review pr — Review the full diff of the current pull request against its base branch
• /docs generate — Auto-generate project documentation based on source code analysis
• /docs readme — Generate or update README.md with project overview, usage, and API docs
• /docs architecture — Generate an architecture overview with Mermaid diagrams
• /docs changelog — Generate a formatted changelog from git commit history

Git & GitHub

• /commit — Generate an AI commit message from the staged diff and open it for review
• /commit-push-pr — Commit with an AI message, push to origin, and open a draft pull request
• /pr — Create a GitHub pull request with an AI-generated title and description
• /issue — Create a GitHub issue with AI-assisted title, body, and label suggestions
• /git rebase — Interactive rebase assistant — resolves conflicts with AI explanations
• /git conflicts — Detect merge conflicts in the working tree and suggest resolutions
• /git cherry-pick <sha> — Cherry-pick a commit with risk assessment for conflicts
  Example: /git cherry-pick a3f9c12
• /git stash — Stash management: save, list, apply, and drop with descriptive names

Infrastructure & DevOps

• /docker ps\|logs\|compose\|build — Container management: list containers, stream logs, run Compose, build images
  Example: /docker logs my-api-container
• /k8s pods\|logs\|apply\|describe — Kubernetes cluster management: inspect workloads, stream logs, apply manifests
  Example: /k8s pods --namespace production
• /iac plan\|apply\|validate\|drift — Terraform/OpenTofu IaC management with AI-generated plan summaries
  Example: /iac drift
• /pipeline generate\|lint\|run — CI/CD pipeline builder: generates GitHub Actions, GitLab CI, or Jenkinsfile
  Example: /pipeline generate --provider github-actions
• /ssh list\|connect\|tunnel\|keys — SSH session manager: save hosts, connect, set up tunnels, manage keys
  Example: /ssh connect prod-bastion

Security & Vault

• /security scan — Scan the project for vulnerability patterns — SQL injection, XSS, path traversal, and more
• /security secrets — Detect hardcoded credentials, API keys, and tokens in source files
• /security deps — Audit project dependencies against the CVE database and advisory feeds
• /security report — Generate a comprehensive security report combining scan, secrets, and dep audit results
• /vault setup — Initialize an encrypted credential vault (AES-256-GCM + Argon2id key derivation)
• /vault unlock — Unlock the vault with your master password to begin a session
• /vault store <label> — Store a credential in the vault, encrypted at rest
  Example: /vault store github-token
• /vault get <label> — Decrypt and retrieve a credential, optionally copying it to the clipboard
  Example: /vault get github-token
• /vault totp add <label> — Add a TOTP entry to the vault using a seed or QR code
  Example: /vault totp add github-2fa
• /vault totp <label> — Generate the current TOTP code for a stored entry
  Example: /vault totp github-2fa

Database & API

• /db connect — Connect to a database (PostgreSQL, MySQL, SQLite, MongoDB) using a connection string
  Example: /db connect postgresql://localhost/myapp
• /db schema — Inspect and visualize the database schema with table relationships
• /db query — Run a SQL query with AI-assisted query building and result explanation
• /db migrate — Generate and apply database migrations with dry-run preview
• /api spec — Generate an OpenAPI 3.1 spec from route definitions in your source code
• /api mock — Start a mock server from an OpenAPI spec, returning realistic fake data
• /api test — Run API endpoint tests against a live or mock server
• /api docs — Generate human-readable API documentation from an OpenAPI spec

Notifications

• /notify send <msg> — Send a desktop notification (macOS, Linux with libnotify)
  Example: /notify send 'Build complete'
• /notify discord <webhook> <msg> — Post a message to a Discord channel via webhook URL
• /notify slack <webhook> <msg> — Post a message to a Slack channel via incoming webhook
• /notify telegram <chat_id> <msg> — Send a Telegram message via bot token to a chat or channel
• /notify whatsapp <number> <msg> — Send a WhatsApp message to a phone number via configured gateway
• /notify signal <number> <msg> — Send a Signal message via signal-cli to a registered number
• /notify matrix <room> <msg> — Post a message to a Matrix room using the configured homeserver token
  Example: /notify matrix '!roomid:matrix.org' 'Deploy done'
• /notify webhook <url> <msg> — POST a JSON payload to any generic webhook endpoint

Workspace & Memory

• /memory — View, search, and manage persistent memory entries stored in the QMD knowledge base
• /memory browse — Open the navigable in-TUI memory browser — filter by tier (user/feedback/project/reference/workflow/anti-pattern), read entries, follow [[links]]. Dangling links are flagged.
• /memory graph — Text dump of the memory graph: entries grouped by tier with recency + link counts, plus the [[link]] edges with dangling links flagged.
• /memory dangling — Report [[link]] targets that reference memories which don't exist yet, grouped by the missing target and who references it. Read-only.
• /memory layer 1 — Live snapshot of the working-memory inventory — kind, size, and preview for every section in injection order
• /memory show episodic\|procedural\|cache — Enumerate the contents of an individual memory layer — episodic (daily summaries + history + sessions), procedural (goals + skills + cron), or cache (file-cache + command-cache + QMD-cache stats)
  Example: /memory show episodic
• /memory promote <nomination-id> — Persist a nominated fact to disk with provenance comments. Use --target <file> to route to a specific file (relative, absolute, or ~-expanded)
  Example: /memory promote nom-2026-05-22-001 --target ~/.anvil/ANVIL.md
• /memory prune episodic — TTL-based retention with trash-bin safety. --dry-run is default ON; --confirm is required for actual moves. Default TTL 90 days, override via --ttl <days>
  Example: /memory prune episodic --ttl 60 --confirm
• /memory prune cache --dry-run — Walk file-cache and command-cache for stale/missing-file candidates without mutating anything; pair with /file-cache prune and /cmd-cache prune for the actual sweep
• /init — Initialize Anvil in the current project — creates anvil.toml with recommended defaults
• /config — View or edit the Anvil configuration file directly
• /timestamps on\|off — Toggle the per-message timestamp prefix ([YYYY.MM.DD.HH:MM]). On by default; display-only — never written into the message text, so copy/paste stays clean.
• /configure — Open the interactive configuration menu for providers, models, and preferences — includes a Language Picker submenu with all 18 locales rendered in their native script
• /context — Inspect and manage the current conversation context window contents
• /pin <file> — Pin a file to the active context so it is always included in AI requests
  Example: /pin src/types/index.ts
• /unpin <file> — Remove a previously pinned file from the active context

AnvilHub & Plugins

• /hub — Open the AnvilHub browser in the terminal — navigate packages by category
• /hub search <query> — Search AnvilHub packages by name, description, or tag
  Example: /hub search kubernetes
• /hub install <name> — Install a package from AnvilHub into the current Anvil installation
  Example: /hub install culpur/anvil-k8s
• /plugin list — List all installed plugins with version and enabled status
• /plugin install <name> — Install a plugin by name from AnvilHub or a local path
• /plugin enable\|disable <name> — Enable or disable an installed plugin without uninstalling it
• /plugin-sdk init — Scaffold a new plugin with the recommended directory structure and manifest
  Example: /plugin-sdk init my-plugin
• /plugin-sdk build — Build the plugin in the current directory and verify the manifest
• /plugin-sdk test — Run the plugin test suite against the Anvil plugin API sandbox
• /plugin-sdk publish — Publish the plugin to AnvilHub — requires authentication

Remote Control

• /remote-control — Start a remote control session — generates URL + 6-digit pairing code, opens browser automatically
  Example: /remote-control → generates URL + 6-digit code
• /local-control — Like /remote-control, but serves the web viewer LOCALLY over loopback (127.0.0.1) — every remote-control feature plus the memory browser, no cloud round-trip. Same pairing-PIN flow.
  Example: /local-control → opens http://127.0.0.1:<port>/viewer/… + 6-digit code
• /local-control status / stop — Check the local server status, or stop it.
• /remote-control status — Check remote control connection status and client count
• /remote-control stop — End the remote control session and disconnect all viewers

Advanced & Automation

• /scaffold new <template> — Generate a full project skeleton from a template (rust / node / python / react / nextjs / go / docker)
  Example: /scaffold new nextjs my-app
• /perf profile\|benchmark\|flamegraph — Profile a running process, run microbenchmarks, or generate a flamegraph SVG
  Example: /perf flamegraph --bin my-server
• /debug start\|breakpoint\|watch\|explain — Debugging assistant: set breakpoints, watch variables, and get AI explanations of crashes
• /logs tail\|search\|analyze\|stats — Log analysis: tail live logs, search by pattern, get AI anomaly detection, view stats
  Example: /logs analyze --file /var/log/app.log
• /regex build\|test\|explain — Regex builder: describe what you need in plain English, test against samples, explain existing patterns
  Example: /regex build 'match ISO 8601 datetimes'
• /migrate framework\|language\|deps — Guided codebase migration assistant for framework upgrades, language ports, and dependency updates
  Example: /migrate framework react-17-to-18
• /snippets save\|list\|get\|search — Personal code snippet library — save, tag, retrieve, and search reusable code blocks
  Example: /snippets save db-pagination
• /deps tree\|outdated\|audit\|why — Dependency management: visualize the dep tree, find outdated packages, audit CVEs, explain why a dep is included
• /mono list\|graph\|changed\|run — Monorepo workspace tools: list packages, graph dependencies, find changed packages, run scoped commands
  Example: /mono changed --since main
• /notebook run\|cell\|export — Jupyter notebook support: run notebooks, execute individual cells, export to script
  Example: /notebook run analysis.ipynb
• /lsp start\|symbols\|references — Language server integration: start an LSP, query symbols, find all references
  Example: /lsp references src/auth.ts:42
• /markdown preview\|toc\|lint — Markdown tools: preview rendered output, generate table of contents, lint for broken links
• /env show\|set\|load\|diff — Environment variable management: inspect current env, set values, load from .env files, diff environments
  Example: /env diff .env .env.production
• /changelog — Auto-generate a formatted changelog from git history using conventional commit parsing
• /finetune prepare\|validate\|start\|status — AI model fine-tuning pipeline: prepare training data, validate format, submit a fine-tuning job, check status
• /webhook list\|add\|test\|remove — Webhook endpoint management: register, test with sample payloads, and remove endpoints
• /browser open\|screenshot\|test — Browser automation: open a URL in a headless browser, take screenshots, run interaction tests
  Example: /browser screenshot https://example.com
• /theme set\|create\|import\|export — Theme customization: switch between 8 built-in themes, create custom themes, import/export theme files
  Example: /theme set monokai