Skip to content

AXM Logo

axm-forge

Developer tools for the AXM ecosystem — AST introspection, code auditing, project scaffolding, and git automation.

CI axm-audit axm-init Coverage Python 3.12+ License

Philosophy

AXM Forge provides the developer toolchain for the AXM ecosystem. Every tool returns structured, deterministic results — designed for AI agents that need precise answers, not text to parse.

  • AST-Powered Introspection

    Tree-sitter based analysis that understands Python at the structural level. Find callers, measure blast radius, and trace import graphs — all without grep noise. Every query returns precise, semantic results.

  • Codified Quality Gates

    40+ rules covering lint, types, coverage, complexity, security, and project governance — all in a single verify() call. Scores and grades make quality measurable and comparable.

  • Automated Scaffolding

    Generate projects, workspaces, and workspace members that pass all 39 governance checks from day one. Copier templates encode AXM conventions so every new package starts production-ready.

  • Git Workflow Automation

    Structured commits with auto-staging, pre-commit retry, and conventional commit enforcement. Semver tagging and push — all through agent-friendly MCP tools.

  • Token Compaction

    Deterministic strategies to shrink LLM inputs — whitespace collapse, null stripping, table compaction, deduplication — with presets from safe to aggressive. Fit more context, spend fewer tokens.

Workspace Packages

Package Description Version Quality
axm-ast AST introspection CLI for AI agents, powered by tree-sitter PyPI audit cov
axm-audit Code auditing and quality rules for Python projects PyPI audit cov
axm-init Python project scaffolding CLI with Copier templates PyPI audit cov
axm-git Git workflow automation for AXM agents PyPI audit cov
axm-smelt Deterministic token compaction for LLM inputs PyPI audit cov

Quick Start

Bash
# Install the workspace
uv sync --all-groups

# Run all tests
make test-all

# Lint + type check
make lint

# Full AXM quality gate (pre-push)
make quality

Architecture

graph TD
    classDef ast fill:#5C6BC0,stroke:#3949AB
    classDef audit fill:#42A5F5,stroke:#1E88E5
    classDef init fill:#26C6DA,stroke:#00ACC1
    classDef git fill:#78909C,stroke:#546E7A
    classDef smelt fill:#FFA726,stroke:#FB8C00

    AST["axm-ast\nAST introspection"]:::ast
    AUDIT["axm-audit\nCode auditing"]:::audit --> AST
    INIT["axm-init\nScaffolding"]:::init
    GIT["axm-git\nGit automation"]:::git
    SMELT["axm-smelt\nToken compaction"]:::smelt

Learn More