Rendering & site

Commands that produce output — rendered nodes, exports, and the docs site.

axiom-graph

Axiom-graph – project knowledge indexer for AI agents.

Usage

axiom-graph [OPTIONS] COMMAND [ARGS]...

render

Render nodes at the specified detail level.

Usage

axiom-graph render [OPTIONS] PROJECT_ROOT

Options

--level <level>

Required Output detail level.

Options:

0 | 1 | 2 | steps

--id <node_id>

Render a single node by ID.

--type <node_type>

Filter by node type.

Arguments

PROJECT_ROOT

Required argument

render-site

Render consumer documentation site from DocJSON sources.

With no --nav/--output, renders every configured render target ([[axiom_graph.site.targets]]), or the subset named by --target (repeatable). When no targets are configured an implicit guide (sphinx -> userdocs/guide) target is synthesised.

--nav/--output are single-target ad-hoc overrides that bypass the target list entirely and render one nav-driven Sphinx subtree.

Usage

axiom-graph render-site [OPTIONS] PROJECT_ROOT

Options

--nav <nav_path>

Path to site-nav.yml (default: site-nav.yml)

--output <output_dir>

Output directory (default: userdocs/guide/)

--target <targets>

Render only the named target(s) from [[axiom_graph.site.targets]] (repeatable).

--build

Run sphinx-build after generating the MyST pages

Arguments

PROJECT_ROOT

Required argument

export

Export the full index to .axiom_graph/index.json.

Usage

axiom-graph export [OPTIONS] PROJECT_ROOT

Arguments

PROJECT_ROOT

Required argument

viz

Launch the axiom-graph visualization dashboard.

Requires the viz extras: pip install axiom-graph[viz]

Usage

axiom-graph viz [OPTIONS] PROJECT_ROOT

Options

--port <port>

Port to listen on.

Default:

8080

--no-browser

Don’t open a browser tab automatically.

Arguments

PROJECT_ROOT

Required argument