axm-forge
Developer tools and the SDK that connects them.
AXM Forge is a uv workspace of independently versioned Python packages for
code analysis, quality checks, editing, scaffolding and Git operations.
Use the tools through an MCP client or the generic axm CLI; use the
libraries directly when integrating them into Python applications.
Start with your task
-
Understand code
Find symbols, inspect signatures and trace callers with axm-ast.
-
Check a project
Run quality rules and tests, check project conventions, or combine them through MCP verify.
-
Make a change
Use axm-edit for batches of file edits and axm-anvil for Python symbol refactoring. Review validation, rollback and post-processing limits before applying changes.
-
Manage the workflow
Inspect and commit with axm-git, find reuse candidates with axm-echo, or compact context with axm-smelt.
Quick Start
- MCP client: use the stdio quick start for a client-managed process, or the HTTP setup for a persistent server shared by several clients. Both transports are supported.
- Local checkout: follow your first workspace query.
- Choose a package: browse the complete catalog, including configuration, secrets and environment diagnostics.
- Contribute: use the development guide.
Philosophy
Tools return a shared result envelope, but each operation has its own data, failure conditions and effects. Read the returned quality verdicts and errors; successful dispatch alone does not prove a project is healthy.
Code analysis and similarity results have limits. Editing tools validate requests and attempt recovery; they cannot guarantee an all-or-nothing transaction across every file and post-processing step. Package references describe those contracts.
Architecture
The architecture guide explains SDK, transport, analysis, mutation and runtime-configuration boundaries. The Node/Svelte overview describes current support and links to package contracts.
Workspace Packages
The package catalog lists all 14 members and their entry points. Each package owns its tutorials, guides and API reference; this workspace documentation covers installation, composition and contribution.