Anvil

Docs · The anvil command

The anvil command

Everything Anvil does has a command, for you in a terminal and for scripts and other agents. Every command takes --json.

Threads

anvil threads [--project p]
anvil thread start --project ~/code/app --on workbox --title "Fix the flaky test" \
  --prompt "The test in x_test.go fails one run in five; find why and fix it."
anvil thread send 9f449e93 "Also check the Linux build." --wait 120
anvil thread read 9f449e93 --last 5
anvil thread allow 9f449e93 [--always]
anvil thread deny 9f449e93 --why "not now"
anvil thread move 9f449e93 --on auto

Issues, changes and checks

anvil issue new --project harbor "Upload retries give up after one 503"
anvil issue list --project harbor --label bug
anvil change open --title "Retry uploads on a 503"
anvil change review harbor#213 --agent
anvil change merge harbor#213
anvil checks run e2e --on win-box

Releases

anvil release new 1.4.0 --project harbor
anvil release publish 1.4.0

Machines and the queue

anvil machines
anvil machines add workbox --target you@workbox
anvil queue add --project ~/code/app --on auto --priority 2 --after-lane spike --prompt-file brief.md
anvil queue list
anvil queue cancel q-8f0955d807

Anvil itself

anvil update [--check] [--channel dev]
anvil node serve
anvil node status

A thread is its id, the first 8 characters of it, or its title; a project is its folder or its name. With no running Anvil to talk to, commands say so and exit 1.