axiomcode

axiomcode command [args] [options]axiomcode --versionaxiomcode help [command]

axiomcode is the CLI for AxiomCode Graph. It parses a repository and builds a call graph with language-aware, deterministic rules: each call is resolved from the receiver's type the way a compiler would, not by matching names in a syntax tree. Queries print numbered places with the enclosing function's code and the relevant line marked.Public verbs: impact, path, tests, context, link, index, report, graph. The first query builds `.axiomcode/out/graph.sqlite` if it is missing. Later queries read that graph. After an edit, a background rebuild can start; the current command still answers from the previous graph and marks rows that may be stale. --fresh waits for the new graph. AXIOMCODE_NO_REFRESH=1 or --no-refresh never starts a rebuild.Stable languages: Java, TypeScript, Python. JavaScript and C# are beta. A multi-language repo gets one graph per language. The npm package @axiomcode/code-graph installs the `axiomcode` binary (`npm i -g` or `npx -y @axiomcode/code-graph`). Node 22.13+ (it writes the graph with `node:sqlite`) and python3 are required. Prebuilt engines ship for macOS (arm64, x64), Linux (x64, arm64), and Windows x64; Linux arm64 compiles native parser modules at install time. Version 0.1.11. License FSL-1.1-Apache-2.0.The agent plugin (Claude Code, Codex, Copilot, Gemini, Cursor) is optional. Any MCP client can run `axiomcode mcp` (or `npx -y @axiomcode/code-graph mcp`).

--lang LIST

Restrict to `java`, `typescript`, `python`, `javascript`, and/or `csharp`.

Limit the analysed tree (for example `src`).

Dependency or platform roots for resolving calls into libraries.

Wait for a refresh in flight and answer from the new graph. AXIOMCODE_FRESH_WAIT (seconds, default 0) applies to every query.

Read-only: do not start a rebuild. Same as AXIOMCODE_NO_REFRESH=1.

Print the package version. Only when it is the sole argument.

.axiomcode/

Per-repository graph, refresh log, and HTML output. Add it to `.gitignore`.

Rebuild policy. Interval is seconds between MCP idle refreshes; 0 turns that timer off.

Checkout root when developing from source (`export AXIOMCODE_ENGINE="$PWD"`).

impact [NAME]

Who calls it, what a change reaches, and the tests that exercise it. With no name: the same for declarations your uncommitted edits changed (`your edits:`).

How A reaches B, hop by hop. Names are written as in the code: `Owner.method`, `method`, `Type`, or `file.py:123`. `*` as an endpoint means everything that reaches, or is reached by, the other name.

Tests your uncommitted edits reach, and a last `run:` line with the command that runs them.

Files and callables a task touches, as a narrative. --source includes each step's code.

Record where a call the graph could not resolve lands (`axiomcode-links.tsv`). Impact, path, and tests then walk it as `[asserted]`. Alone, lists links. `link FILE:LINE -` removes one.

Build the graph explicitly. REPO defaults to the current directory.

HTML page of end-of-turn assist receipts (`.axiomcode/assists.html`).

Interactive HTML graph; prints `<repo>/.axiomcode/graph/graph.html`.

MCP server on stdio (tools impact, path, tests, and related).

Dispatcher help, or one command's usage.

Needs Node 22.13+ and Python 3. Linux arm64 needs build tools (`build-essential`, `python3`) so native parser modules can compile. Windows runs the CLI under Git Bash. Unresolved calls stay explicit rather than guessed; reflection and service loaders can miss edges. A graph built by another engine or `IMPACT_VERSION` is not rebuilt by hooks. First index of a large repo can take minutes.

graf(1), graphify-csharp(1), ctags(1), cscope(1), ast-grep(1), rg(1), npm(1), node(1), python3(1)

Source code · Homepage · Documentation