Anvil

Quickstart · Documentation · Ten-minute evaluation · Discord

Anvil is a Rust Agent Client Protocol server: one reusable agent engine for editors, bots, TUIs, and internal tools.

It is intentionally just the ACP server. Anvil owns model routing, the tool loop, permission enforcement, sessions, context compaction, sandboxing, and MCP integration. The ACP client owns the user experience.

ACP client              stdio / JSON-RPC              Anvil
----------              ----------------              -----
Zed        ----------------------------------------->  agent loop
JetBrains   --------------------------------------->  model routing
issue bot   --------------------------------------->  permission gate
custom TUI  --------------------------------------->  tools + sessions

Why Anvil

• One engine, many frontends. Reuse the same execution semantics from a supported editor or any ACP-over-stdio client.
• Model routing built in. Connect Codex/ChatGPT, Bedrock, Ollama, ds4, DeepSeek, Kimi, OpenAI-compatible providers, or OpenRouter.
• Real agent tooling. Filesystem and shell tools, managed Bifrost code intelligence, MCP servers, skills, plugins, and subagents.
• Explicit safety boundaries. Clients choose permission behavior while Anvil applies permission gates, workspace path checks, and the configured sandbox strategy.
• Persistent work. Load and resume sessions with durable history, usage reporting, and context compaction.

Install and Evaluate

Download a checksum-verified binary from GitHub Releases, or install from crates.io:

rustup target add wasm32-wasip2
cargo install brokk-anvil --locked --force
anvil --version

Running anvil directly starts a stdio JSON-RPC server; use it through an ACP client. Continue with the installation guide or the reproducible ten-minute evaluation.

Supported Clients

• Zed and JetBrains have repository-backed setup helpers and verified configuration shapes.
• Other ACP clients can launch Anvil as a custom stdio agent.
• The client-building guide and examples/ show issue triage, review, and issue-drafting automations.

Documentation and Development

The Anvil documentation is the canonical user reference for providers, commands, tools, permissions, sessions, extensibility, and trust boundaries.

See CONTRIBUTING.md for source development, runtime invariants, tests, dependency-license policy, pull requests, and releases.

License

Anvil is licensed under LGPL-3.0-only. See the practical License and Use Cases guide, the controlling LICENSE, and third-party notices.