ANVIL v1.1.2 is live on npm registry

Make every code change predictable and verified.

The local-first AI engineering workbench that maps codebase architecture across major languages (TS/JS, Python, Go, Rust, Java, C/C++), prunes junk and auto-fixes code with instant rollback, audits change risk, and self-heals via test verification — with zero telemetry leakage and full developer control.

100% Local-First Multi-Language Map & TS/JS AST Self-Healing Clean & Fix Instant Snapshot Undo
anvil — local engineering session
LIVE v1.1.2
QUICK START INSTALLATION

Bring ANVIL into your development environment

Run instantly with npx or install globally via your preferred package manager. Requires Node.js 22+.

$ npm install -g anvil-engineering-workbench
Supported Adapters Claude Code MCP STDIO Cursor IDE MCP CLIENT Local Models OLLAMA Cloud APIs OPENAI · ANTHROPIC · GEMINI Platform NODE 22+ · TS 5.8+
100%
Local-First Privacy
Your code, AST symbols, and git history never leave your local workspace without explicit configuration.
16+
14
Deep Tooling Engines
From TypeScript AST analysis and circular import graphs to heuristic git change-risk and regression tracking.
0 KB
Cloud Telemetry Leakage
Zero tracking scripts, zero background phoning home. Saved state lives safely in your local .anvil/ folder.
MIT
Open-Source License
Fully auditable source code, forkable, and ready for community expansion on GitHub.
INSIDE THE WORKBENCH

Engineering evidence, not mystery automation.

Explore the four core facets of ANVIL. Each engine gathers concrete evidence to guide your decisions rather than modifying your files silently.

ANVIL / PROJECT PROFILE STAGE ● LOCAL WORKSPACE SIMULATION ● LOCAL WORKSPACE CLI WALKTHROUGH
COMPLETE TOOLKIT

Built for every step of the software lifecycle.

From initial codebase discovery to post-merge verification, ANVIL provides purpose-built tools that give you structural clarity.

⌘
01

Project Discovery

Scan languages, manifests, frameworks, scripts, and dependency counts before touching a single line of code.

anvil inspect
⌗
02

Architecture Mapping

Map internal module relationships, external package imports, entry points, and circular dependency rings.

anvil map · deep
⚡
03

AST Symbol Analysis

Parse TypeScript syntax trees to extract functions, classes, interfaces, and transitive blast-radius paths.

TypeScript AST
⌁
04

Change-Risk Assessment

Correlate working-tree git changes with downstream architectural hotspots and recommended test suites.

anvil git
⌕
05

Review History

Save code review snapshots, inspect individual findings, and compare reviews across commits over time.

anvil review-history
⟐
06

Dry-Run Patch Validation

Validate proposed unified diffs for target file paths, hunk syntax, and source context without applying them.

anvil patch-check
✓
07

Verification Engine

Run named project test or build scripts deliberately, capturing standard outputs, exit codes, and timestamps.

anvil verify
↗
08

Regression Intelligence

Compare saved verification outcomes to identify regressions, recoveries, persistent failures, and stable runs.

anvil regression
◉
09

Engineering Health Score

Synthesize quality, verification, and dependency evidence into an honest, weighted engineering health metric.

anvil health
⛓
10

Dependency Intelligence

Inspect npm package manifests, lockfiles, and audit reports for vulnerability flags, outdated ranges, and licenses.

anvil deps
✳
11

Remediation Planner

Prioritize critical dependency findings and generate reviewable upgrade strategies without silent package installs.

anvil remediate
▦
12

Local Web Dashboard

Launch an interactive local control center with live SSE broadcasts, interactive graphs, and run inspectors.

anvil dashboard
🧹
13

Automated Junk Cleaner & Fix

Scrub OS residue, partial downloads, error logs, and multi-language caches, with safe unused-import auto-repair.

anvil clean · fix
🩺
14

Self-Healing Doctor Wizard

Automate environment health diagnostics with one-command scaffolding of .anvil directories, .gitignore, and .env.

anvil doctor --fix
SYSTEM ARCHITECTURE

How ANVIL works under the hood.

A decoupled, local-first pipeline designed to process real project trees without sending your proprietary source code to third-party endpoints.

WORKSPACE Local Filesystem ANVIL CORE AST & Graph Engine MCP SERVER Claude / Cursor LOCAL STORE .anvil/ State DASHBOARD Localhost UI
STANDALONE WEB INTERFACE

Launch your local engineering control center

Run the dashboard directly on your machine. Inspect architecture, visualize real-time dependency graphs, review audit trails, and approve agent actions through a sleek localhost interface.

# Launch dashboard for any repository
$ anvil dashboard ./your-project

✓ Dashboard running at: http://127.0.0.1:4173
✓ Realtime SSE event stream active
✓ Safe sandbox & local file preview ready
EXTENSIBILITY

Integrates directly with your AI engineering stack.

Connect ANVIL's local read-only MCP server to your AI editor or invoke specialized CLI workflows from automated pipelines.

MCP SERVER

Claude Code

Register ANVIL as a local stdio MCP tool server so Claude can map architecture, search symbols, and audit codebase risk.

MCP CLIENT

Cursor IDE

Add ANVIL to your project's .cursor/mcp.json for instant repository context inside Composer and Chat.

LOCAL LLM

Ollama

Point ANVIL to your local Ollama endpoint for zero-cloud, 100% private review suggestions and diff generation.

API PROVIDERS

OpenAI · Anthropic · Gemini

Configure your own API keys for optional high-reasoning patch proposals and security analysis.

THE ENGINEERING LIFECYCLE

A repeatable, disciplined loop

From unfamiliar legacy repositories to safely verified pull requests.

PHASE 01

Understand

Inspect frameworks, package manifests, scripts, and build setup before modifying any source code.

PHASE 02

Map

Trace module dependencies, AST symbols, entry points, and structural hotspots across files.

PHASE 03

Review

Analyze Git uncommitted diffs, assess downstream blast radius, and validate proposed unified patches.

PHASE 04

Verify

Execute named test scripts, save deterministic outcome logs, and catch regressions before merging.

FREQUENTLY ASKED QUESTIONS

Everything you need to know.

Does ANVIL automatically apply changes to my code?

No. By design, ANVIL enforces human approval for consequential actions. Patch validation is a dry run that inspects diff structure, and remediation generation produces a plan rather than silently modifying dependencies.

Is ANVIL's local dashboard a hosted web app?

No. The dashboard runs 100% locally on your machine via Node.js and binds to localhost. Your repository source code, AST index, and git history never get uploaded to any external server.

Which languages are supported for deep AST analysis?

TypeScript and JavaScript have native, deep AST and symbol-level analysis. For other languages (Python, Go, Rust, Java), ANVIL provides manifest parsing, configuration audits, script runners, and git change-risk heuristics.

How do I connect ANVIL with Claude Code or Cursor?

ANVIL provides a built-in MCP server (`anvil mcp` or through the CLI). Simply add it to your Claude Code or Cursor configuration file to grant AI assistants read-only access to ANVIL's repository intelligence tools.

What is required to run ANVIL?

ANVIL requires Node.js version 22 or higher. It works seamlessly across macOS, Linux, and Windows PowerShell.

Is ANVIL completely free and open source?

Yes. ANVIL is licensed under the permissive MIT License. You have complete freedom to inspect, fork, contribute, and use it in commercial or open-source projects.

START ENGINEERING TODAY

Ready to bring clarity to your codebase?

Install ANVIL in seconds or explore the complete open-source repository on GitHub.