Anvil

Deterministic development automation that makes AI-generated code changes safe for production. Validate plans through quality gates before execution, ensuring changes meet your team's standards.

Quick Start

# Try without installing
npx @eddacraft/anvil-cli login
npx @eddacraft/anvil-cli tutorial

# Or install globally
npm install -g @eddacraft/anvil-cli
# or: pnpm add -g @eddacraft/anvil-cli
# or: yarn global add @eddacraft/anvil-cli
# or: bun add -g @eddacraft/anvil-cli
anvil login
anvil tutorial

For the current beta, authenticate first with your beta token. The interactive tutorial takes about 5 minutes and walks you through scanning, watching, and fixing issues.

What Anvil Does

• Quality gates - validate code changes against architecture rules, anti-patterns, and team conventions
• Plan validation - check planning documents (APS, SpecKit, BMAD) before execution
• Architecture enforcement - define boundaries, layers, and dependency rules
• Real-time watch mode - validate as you code with instant feedback
• AI authorship tracking - trace which changes were AI-generated via Git Notes
• OPA/Rego policies - write custom rules for your organisation

Commands

| Command | Description | | ---------------------- | ------------------------------- | | anvil tutorial | Interactive guided tutorial | | anvil init | Set up Anvil in a project | | anvil check --all | Scan codebase for issues | | anvil watch --source | Real-time validation | | anvil gate | Run quality gates | | anvil doctor | Diagnostics and troubleshooting | | anvil explain <rule> | Understand a warning | | anvil status | Show workspace status | | anvil --help | See all commands |

Requirements

• Node.js 20.19.0 or later
• A package manager: pnpm, npm, yarn, or bun
• Git

Beta

This is an early beta release. We welcome bug reports and feedback:

• Report a bug
• Request a feature
• Share feedback

Documentation

• Beta Quickstart
• CLI Command Reference

Licence

Apache-2.0