Documentation

Learn Anvil by topic.

Guided walkthroughs, worked examples, and screenshots for every part of Anvil — from your first session in the terminal to running a crew across a fleet of machines. Pick a topic, or start at the beginning.

Start here

Getting started

Install Anvil, sign in to your providers, and run your first session in the terminal and the browser.

Setup & first run

What happens the first time you run Anvil — the four-screen setup wizard, in your browser or your terminal.

AnvilHub vs the terminal

Local vs AnvilHub — the two doors

Anvil runs the same on your machine whether you connect it to AnvilHub or not. This is what the connection adds, and how to make it.

Doing it in AnvilHub

Everything you do in the terminal has a place in AnvilHub. Here's the map — command to screen — and why the graphical way is worth it.

The workspace

Chat, coding, and the live session — how you actually work with Anvil day to day.

Canvas & publish

See what your agent produced — pages, components, documents — and publish or share it.

Models & providers

Anvil talks to 35 providers with your own keys. Connect as many as you like, switch models mid-session, and let it route or fail over automatically.

Your crew & fleet

Anvil isn't one assistant — it's a crew you delegate to, running across a fleet of machines you steer from one place. This is the map of how it fits together.

Squads — how delegation works

A squad isn't a list of people — it's a capability you ask for, and Anvil picks the right specialist. Here's why that matters.

Bots & the Team board

A bot is a persistent worker on an instance's team — a name, a role, a model, and a ceiling it can never exceed. Here's how to run a crew.

Instances & the fleet

Every machine running Anvil is an instance. Connect several to AnvilHub and they become a fleet you steer from one screen.

Runs — the record of work

Every piece of work your crew does is recorded — what ran, what it changed, what it cost. The terminal shows it once; AnvilHub keeps it.

Teams & orgs

Run Anvil for an organisation — workspaces, roles, invitations, seat limits, and encrypted team chat.

Cost tracking

See what every turn costs, across every deployment — measured, not guessed.

Knowledge & memory

Memory

How Anvil remembers across sessions, the seven-layer model, and how you view and curate what it keeps.

Knowledge base

Point Anvil at your documents and build a durable, queryable library that never leaves your Anvil.

Security

Security & vault

The encrypted credential vault, your keys staying yours, and zero telemetry.

Permissions & scope

Anvil asks before it does something risky. When it's told no — or there's no one to ask — the request doesn't vanish; it becomes something an admin can decide later.

Marketplace & skills

Marketplace & publishing

Install skills, plugins, agents, and themes — and publish your own.

Skills on demand

Anvil doesn't carry every tool in front of the model at once. It keeps a small core always ready and fetches the rest — skills, tools, capabilities — exactly when a task needs them.

Automation & advanced

Routines, fleet orders, remote control, and the advanced flags that drive Anvil without a human in the loop.

Command reference

Every slash command and CLI flag, grouped by area, with examples.