Install Anvil

A single 13MB binary. No runtime dependencies. Requires QMD (npm install -g @tobilu/qmd) for persistent context and memory.

Install on macOS

One-line install (macOS / Linux)

curl -fsSL https://anvilhub.culpur.net/install.sh | bash

Or via Homebrew (coming soon)

brew install culpur/tap/anvil

After install, log in and start

anvil login
anvil

After Installation

anvil login

Authenticate with your AI provider. Supports OAuth for Anthropic and API keys for OpenAI, Ollama, and xAI.

anvil

Launch Anvil in your current project directory. Anvil reads your project structure automatically.

anvil model claude-sonnet-4-6

Switch to a specific model. Supports claude-*, gpt-*, llama*, and any model available through your configured providers.

anvil continue

Resume your most recent session, restoring context from QMD memory.

anvil install <package>

Install a skill or plugin from AnvilHub. Browse available packages at anvilhub.culpur.net.

QMD — Knowledge Base Engine

QMD is Anvil's knowledge base engine. It indexes your codebase, documentation, and previous sessions so Anvil can automatically inject relevant context into every conversation.

The install script installs QMD automatically. If you need to install it manually:

# Requirements: Node.js 18+ (npm)

npm install -g @tobilu/qmd

# After installation, index your project

qmd collection add myproject /path/to/project/**/*.md

qmd update

qmd embed

Learn more: github.com/tobi/qmd

Troubleshooting

Command not found after install▾

Add ~/.local/bin to your PATH: export PATH="$HOME/.local/bin:$PATH" — add this line to your ~/.bashrc or ~/.zshrc.

anvil login fails with connection error▾

Check your network connection and ensure you have a valid API key for your provider. Run `anvil config` to review your settings.

Permission denied when running the binary▾

Make the binary executable: chmod +x $(which anvil)

Ollama models not showing▾

Ensure Ollama is running locally: `ollama serve` — then run `anvil model list` to see available local models.

Context window filling up too fast▾

Enable QMD archival: `anvil config qmd.autoArchive true` — Anvil will automatically archive and retrieve context as needed.

Having trouble? Check GitHub Issues or browse skills on AnvilHub.

Learn more about Anvil →