![\"Anvil](\"docs/public/anvil-social-card.png\")
\n \n\n \n \n \n
\n ![\"CI\"](\"https://github.com/BrokkAi/anvil/actions/workflows/ci.yml/badge.svg\"){kind=icon}
\n ![\"Latest](\"https://img.shields.io/github/v/release/BrokkAi/anvil\")
![\"crates.io\"](\"https://img.shields.io/crates/v/brokk-anvil\")
![\"LGPL-3.0-only\"](\"https://img.shields.io/github/license/BrokkAi/anvil\")
\n Quickstart ·\n Documentation ·\n Ten-minute evaluation ·\n Discord\n
\n\nAnvil is a Rust [Agent Client Protocol](https://agentclientprotocol.com/) server: one reusable agent engine for editors, bots, TUIs, and internal tools.\n\nIt 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.\n\n```text\nACP client stdio / JSON-RPC Anvil\n---------- ---------------- -----\nZed -----------------------------------------> agent loop\nJetBrains ---------------------------------------> model routing\nissue bot ---------------------------------------> permission gate\ncustom TUI ---------------------------------------> tools + sessions\n```\n\n## Why Anvil\n\n- **One engine, many frontends.** Reuse the same execution semantics from a supported editor or any ACP-over-stdio client.\n- **Model routing built in.** Connect Codex/ChatGPT, Meta/Muse, Bedrock, Ollama, ds4, DeepSeek, Kimi, Grok, OpenAI-compatible providers, or OpenRouter.\n- **Real agent tooling.** Filesystem and shell tools, managed Bifrost code intelligence, MCP servers, skills, plugins, and subagents.\n- **Explicit safety boundaries.** Clients choose permission behavior while Anvil applies permission gates, workspace path checks, and the configured sandbox strategy.\n- **Persistent work.** Load and resume sessions with durable history, usage reporting, and context compaction.\n\n## Python inference client\n\n`uv add brokk-anvil-client` installs native async Python bindings to Anvil's\nstandalone model client. It shares provider authentication, structured output,\nand retries with `anvil infer`, without an agent session or subprocess.\nSee [Python LLM Client](https://anvil.brokk.ai/python-client/).\n\n## Install and Evaluate\n\nInstall the released native binary through [uv](https://docs.astral.sh/uv/),\nwith no Rust toolchain required:\n\n```bash\nuv tool install brokk-anvil\nanvil --version\n\n# later\nuv tool upgrade brokk-anvil\nuv tool uninstall brokk-anvil\n```\n\nThe Python package version pins the matching GitHub release. On first run it\ndownloads the native archive for macOS, Linux glibc, Windows, or\nAndroid/Termux, verifies the published SHA-256 sidecar, and caches the binary.\nSee the [installation guide](https://anvil.brokk.ai/install/#uv) for exact\nversion pins, cache paths, and unsupported-platform behavior.\n\nOr install with Homebrew on macOS (Apple Silicon and Intel) or Linux (x86-64\nand ARM64 glibc):\n\n```bash\nbrew install brokkai/tap/anvil\nanvil --version\n```\n\nOr install through npm on any supported platform (macOS, Linux glibc, Windows, Android/Termux) — the package installs the released native binary, no Rust toolchain needed:\n\n```bash\nnpm install -g @brokkai/anvil\nanvil --version\n\n# or run one-shot without installing\nnpx -y @brokkai/anvil --version\n```\n\nOr install the latest checksum-verified release on macOS, Linux, WSL, or Android/Termux:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/BrokkAi/anvil/refs/heads/master/install.sh | bash\nanvil --version\n```\n\nTo review the installer before running it, download `install.sh`, inspect it, then run it with `bash`. You can also download an archive from [GitHub Releases](https://github.com/BrokkAi/anvil/releases/latest), or install from crates.io:\n\n```bash\nrustup target add wasm32-wasip2\ncargo install brokk-anvil --locked --force\nanvil --version\n```\n\nRunning `anvil` directly starts a stdio JSON-RPC server; use it through an ACP client. Continue with the [installation guide](https://anvil.brokk.ai/install/) or the reproducible [ten-minute evaluation](https://anvil.brokk.ai/evaluate-anvil/).\n\nFor scripts, CI jobs, and Makefiles, `anvil --print` runs one prompt headlessly with a built-in ACP client and exits — no external client required:\n\n```bash\nanvil -p \"summarize the failing test\" # prompt as an argument\necho \"fix this test\" | anvil -p # or on stdin (also: anvil -p -)\nanvil -p \"…\" --output-format json # one JSON object at exit\nanvil -p \"…\" --output-format stream-json # newline-delimited records, result last\nanvil -p \"…\" --permission-mode yolo # manual (default) | auto | yolo\nanvil -p \"…\" --cwd /path/to/repo --model \"codex::gpt-5-codex+high\"\nanvil -p \"…\" --resume SESSION_ID # continue an existing session\n```\n\nHeadless runs never block on a human: `manual` rejects every permission request but still honors agent-side approvals that never reach the client (`read`, `search`, and `fetch`; sandboxed shell commands on the conservative read-only safelist; and remembered repo-scoped **Always allow** grants); `auto` accepts edit/delete/move but rejects shell execution; and `yolo` accepts everything. The final assistant message goes to stdout (`text`), or a machine-readable payload with `session_id`, `resumed`, `result`, `stop_reason`, `usage`, and `error` (`json` / `stream-json`); progress and diagnostics stay on stderr, and the exit code is non-zero on agent or transport failure ([#356](https://github.com/BrokkAi/anvil/issues/356)).\n\n`anvil serve` (included in all official binaries; source builds can opt out with `cargo build --no-default-features --features wasm-sandbox`) starts the same runtime as an HTTP daemon on a loopback listener (default `127.0.0.1:26845`), exposing versioned REST endpoints for session lifecycle, model discovery, the tool catalog, and asynchronous prompt runs with Server-Sent-Event streaming and cancellation (`/health`, `/v1/models`, `/v1/tools`, `/v1/sessions`, `/v1/runs`). The daemon supports bearer-token authentication (required for non-loopback binding), server-enforced workspace roots, and interactive permission approval endpoints. The wire contract is versioned and checked in under [`openapi/`](openapi/) (OpenAPI document, SSE event schema, and compatibility policy), with a black-box conformance suite holding the implementation to it. Generate a client in your preferred language from those contract files.\n\nConfigure a supported ACP client directly from the installed binary:\n\n```bash\nanvil install zed\nanvil install jetbrains\nanvil install neovim --plugin codecompanion\n```\n\n## Supported Clients\n\n- [Zed](https://anvil.brokk.ai/zed/), [JetBrains](https://anvil.brokk.ai/jetbrains/), and [Neovim](https://anvil.brokk.ai/neovim/) have direct installers and verified configuration shapes.\n- [Other ACP clients](https://anvil.brokk.ai/other-acp-clients/) can launch Anvil as a custom stdio agent.\n- The [client-building guide](https://anvil.brokk.ai/build-acp-client/) and `examples/` show issue triage, review, and issue-drafting automations.\n\n## Documentation and Development\n\nThe [Anvil documentation](https://anvil.brokk.ai/) is the canonical user reference for providers, commands, tools, permissions, sessions, extensibility, and trust boundaries.\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for source development, runtime invariants, tests, dependency-license policy, pull requests, and releases.\n\n## License\n\nAnvil is licensed under `LGPL-3.0-only`. See the practical [License and Use Cases](https://anvil.brokk.ai/license-use-cases/) guide, the controlling [LICENSE](LICENSE), and [third-party notices](https://anvil.brokk.ai/third-party-notices/).\n","readmeFilename":"README.md"}