Anvil CLI Command Reference

Install via Homebrew (macOS)

Install via shell script (Linux / macOS)

Self-update to the latest release without reinstalling

Start the interactive REPL in the current directory

Authenticate with your AI provider (Anthropic OAuth or API key)

Show all available commands with short descriptions

Show current session status: active model, token usage, and provider

Switch AI model mid-session without losing conversation history

Example: /model gpt-4o

Display token costs accumulated in the current session

Clear conversation history and start fresh in the same session

Toggle focus view — show only prompts, tool summaries, and responses (Ctrl+O)

Branch the conversation — create, list, or switch between branches

Example: /fork experiment | /fork list | /fork switch 1

Compress conversation history to a summary to free context window space

Show Anvil version, build hash, and build date

Switch the UI language (en / de / es / fr / ja / zh-CN / ru)

Example: /language de

AST-aware symbol search across the project (functions, classes, structs)

Example: /semantic-search --type function --lang rust authenticate

Rename a symbol across all files in the project with conflict detection

Example: /refactor rename getUserById fetchUserById

Extract a range of lines into a new named function with proper signature inference

Example: /refactor extract src/auth.ts 42-61

Show the current working directory diff with AI-generated change summary

Auto-generate unit tests for a source file using the project's existing test framework

Example: /test generate src/auth/jwt.ts

Run the project test suite — auto-detects Cargo, npm, pytest, and go test

Generate a test coverage report and highlight uncovered branches

AI code review of a single file: security issues, logic errors, and style

Example: /review src/api/auth.ts

Review all staged git changes before committing — catches issues early

Review the full diff of the current pull request against its base branch

Auto-generate project documentation based on source code analysis

Generate or update README.md with project overview, usage, and API docs

Generate an architecture overview with Mermaid diagrams

Generate a formatted changelog from git commit history

Generate an AI commit message from the staged diff and open it for review

Commit with an AI message, push to origin, and open a draft pull request

Create a GitHub pull request with an AI-generated title and description

Create a GitHub issue with AI-assisted title, body, and label suggestions

Interactive rebase assistant — resolves conflicts with AI explanations

Detect merge conflicts in the working tree and suggest resolutions

Cherry-pick a commit with risk assessment for conflicts

Example: /git cherry-pick a3f9c12

Stash management: save, list, apply, and drop with descriptive names

Container management: list containers, stream logs, run Compose, build images

Example: /docker logs my-api-container

Kubernetes cluster management: inspect workloads, stream logs, apply manifests

Example: /k8s pods --namespace production

Terraform/OpenTofu IaC management with AI-generated plan summaries

Example: /iac drift

CI/CD pipeline builder: generates GitHub Actions, GitLab CI, or Jenkinsfile

Example: /pipeline generate --provider github-actions

SSH session manager: save hosts, connect, set up tunnels, manage keys

Example: /ssh connect prod-bastion

Scan the project for vulnerability patterns — SQL injection, XSS, path traversal, and more

Detect hardcoded credentials, API keys, and tokens in source files

Audit project dependencies against the CVE database and advisory feeds

Generate a comprehensive security report combining scan, secrets, and dep audit results

Initialize an encrypted credential vault (AES-256-GCM + Argon2id key derivation)

Unlock the vault with your master password to begin a session

Store a credential in the vault, encrypted at rest

Example: /vault store github-token

Decrypt and retrieve a credential, optionally copying it to the clipboard

Example: /vault get github-token

Add a TOTP entry to the vault using a seed or QR code

Example: /vault totp add github-2fa

Generate the current TOTP code for a stored entry

Example: /vault totp github-2fa

Connect to a database (PostgreSQL, MySQL, SQLite, MongoDB) using a connection string

Example: /db connect postgresql://localhost/myapp

Inspect and visualize the database schema with table relationships

Run a SQL query with AI-assisted query building and result explanation

Generate and apply database migrations with dry-run preview

Generate an OpenAPI 3.1 spec from route definitions in your source code

Start a mock server from an OpenAPI spec, returning realistic fake data

Run API endpoint tests against a live or mock server

Generate human-readable API documentation from an OpenAPI spec

Send a desktop notification (macOS, Linux with libnotify)

Example: /notify send 'Build complete'

Post a message to a Discord channel via webhook URL

Post a message to a Slack channel via incoming webhook

Send a Telegram message via bot token to a chat or channel

Send a WhatsApp message to a phone number via configured gateway

Send a Signal message via signal-cli to a registered number

Post a message to a Matrix room using the configured homeserver token

Example: /notify matrix '!roomid:matrix.org' 'Deploy done'

POST a JSON payload to any generic webhook endpoint

View, search, and manage persistent memory entries stored in the QMD knowledge base

Live snapshot of the working-memory inventory — kind, size, and preview for every section in injection order

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

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

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

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

Initialize Anvil in the current project — creates anvil.toml with recommended defaults

View or edit the Anvil configuration file directly

Open the interactive configuration menu for providers, models, and preferences — includes a Language Picker submenu with all 18 locales rendered in their native script

Inspect and manage the current conversation context window contents

Pin a file to the active context so it is always included in AI requests

Example: /pin src/types/index.ts

Remove a previously pinned file from the active context

Open the AnvilHub browser in the terminal — navigate packages by category

Search AnvilHub packages by name, description, or tag

Example: /hub search kubernetes

Install a package from AnvilHub into the current Anvil installation

Example: /hub install culpur/anvil-k8s

List all installed plugins with version and enabled status

Install a plugin by name from AnvilHub or a local path

Enable or disable an installed plugin without uninstalling it

Scaffold a new plugin with the recommended directory structure and manifest

Example: /plugin-sdk init my-plugin

Build the plugin in the current directory and verify the manifest

Run the plugin test suite against the Anvil plugin API sandbox

Publish the plugin to AnvilHub — requires authentication

Start a remote control session — generates URL + 6-digit pairing code, opens browser automatically

Example: /remote-control → generates URL + 6-digit code

Check remote control connection status and client count

End the remote control session and disconnect all viewers

Generate a full project skeleton from a template (rust / node / python / react / nextjs / go / docker)

Example: /scaffold new nextjs my-app

Profile a running process, run microbenchmarks, or generate a flamegraph SVG

Example: /perf flamegraph --bin my-server

Debugging assistant: set breakpoints, watch variables, and get AI explanations of crashes

Log analysis: tail live logs, search by pattern, get AI anomaly detection, view stats

Example: /logs analyze --file /var/log/app.log

Regex builder: describe what you need in plain English, test against samples, explain existing patterns

Example: /regex build 'match ISO 8601 datetimes'

Guided codebase migration assistant for framework upgrades, language ports, and dependency updates

Example: /migrate framework react-17-to-18

Personal code snippet library — save, tag, retrieve, and search reusable code blocks

Example: /snippets save db-pagination

Dependency management: visualize the dep tree, find outdated packages, audit CVEs, explain why a dep is included

Monorepo workspace tools: list packages, graph dependencies, find changed packages, run scoped commands

Example: /mono changed --since main

Jupyter notebook support: run notebooks, execute individual cells, export to script

Example: /notebook run analysis.ipynb

Language server integration: start an LSP, query symbols, find all references

Example: /lsp references src/auth.ts:42

Markdown tools: preview rendered output, generate table of contents, lint for broken links

Environment variable management: inspect current env, set values, load from .env files, diff environments

Example: /env diff .env .env.production

Auto-generate a formatted changelog from git history using conventional commit parsing

AI model fine-tuning pipeline: prepare training data, validate format, submit a fine-tuning job, check status

Webhook endpoint management: register, test with sample payloads, and remove endpoints

Browser automation: open a URL in a headless browser, take screenshots, run interaction tests

Example: /browser screenshot https://example.com

Theme customization: switch between 8 built-in themes, create custom themes, import/export theme files

Example: /theme set monokai