CLI reference

June 17, 2026 · View on GitHub

Arachne exposes a Typer-based CLI for weaving, executing, inspecting, reusing, and recovering agent graphs.

graph LR
    A[run]
    B[session]
    C[cat]
    D[resume]
    E[graphs]
    F[rerun]
    A --> B
    B --> C
    B --> D
    E --> F

Global pattern

Most commands run through uv during development:

uv run arachne <command> [arguments] [options]

If Arachne is installed as a package, use:

arachne <command> [arguments] [options]

Command summary

Command	Purpose	Typical use
`run`	weave and execute a goal	normal end-to-end workflow
`weave`	generate a graph without executing it	review or cache a topology
`ls`	list recent sessions	find previous runs
`cat`	render a session result	inspect the latest or named output
`graphs`	list cached topologies	find reusable graph ids
`show`	visualise a session or graph	inspect topology structure
`rerun`	execute a previous topology	reuse a proven plan
`resume`	continue a failed or interrupted session	recover work
`clean`	remove old or failed sessions with filters	maintain local state
`compile-weaver`	compile GraphWeaver sub-predictors	improve topology generation
`config`	inspect or update local settings	manage runtime configuration

Core workflow commands

`run`

Weave a graph from a natural-language goal and execute it immediately.

uv run arachne run "Research the current state of humanoid robotics"

With graph review:

uv run arachne run "Research the current state of humanoid robotics" --interactive

Common options:

Option	Meaning
`--interactive`, `-i`	review or clarify the plan before execution
`--max-retries`, `-r`	control repair attempts
`--max-tokens`	override the run token budget

Runtime flow:

graph TD
    A[Goal]
    B[Weave]
    C[Provision]
    D[Execute]
    E[Evaluate]
    F[Output]
    G[Heal]
    A --> B
    B --> C
    C --> D
    D --> E
    E --> F
    E --> G
    G --> D

`weave`

Generate a graph topology without executing it.

uv run arachne weave "Compare graph-based agent frameworks"

Save the topology:

uv run arachne weave "Compare graph-based agent frameworks" --output graph.json

Use this command when you want to inspect structure before allowing a run.

History and inspection

`ls`

List recent sessions.

uv run arachne ls
uv run arachne ls -n 10

Typical columns:

Column	Meaning
Session ID	unique run identifier
Created	timestamp or relative age
Goal	shortened goal text
Graph ID	topology cache identifier
Status	run state

`cat`

Render the final output for a session.

uv run arachne cat last
uv run arachne cat <session-id>

Use last for the most recent session.

`graphs`

List cached graph topologies.

uv run arachne graphs

This is useful when you want to reuse a graph with rerun.

`show`

Visualise a graph from either a session id or graph id.

uv run arachne show <session-id>
uv run arachne show <graph-id>

Reuse and recovery

`rerun`

Execute a fresh session using an existing topology.

uv run arachne rerun <graph-id>

Override the goal while keeping the graph structure:

uv run arachne rerun <graph-id> --goal "Research the same market in Europe"

`resume`

Resume a failed or interrupted session.

uv run arachne resume <session-id>

Recovery flow:

graph TD
    A[Failed session]
    B[Load state]
    C[Diagnose]
    D[Retry]
    E[Re route]
    F[Re weave]
    G[Continue]
    A --> B
    B --> C
    C --> D
    C --> E
    C --> F
    D --> G
    E --> G
    F --> G

Maintenance commands

`clean`

Remove old or failed session data. The command only deletes sessions when a filter is supplied.

# Delete sessions older than 30 days
uv run arachne clean --older-than 30

# Delete failed sessions
uv run arachne clean --failed

Use with care when you rely on session history for audit or reproducibility.

`config`

Inspect or update local runtime settings.

uv run arachne config list

The exact supported actions may evolve while Arachne is in beta.

`compile-weaver`

Compile the GraphWeaver sub-predictors with BootstrapFewShot.

uv run arachne compile-weaver --teacher <model> --max-demos 4

Options:

Option	Meaning
`--teacher`, `-t`	teacher model for bootstrapping
`--max-demos`, `-n`	maximum number of bootstrapped demonstrations
`--output-dir`, `-o`	output directory for compiled predictors

Recommended workflows

First run

./quickstart.sh
uv run arachne run "Research a topic" --interactive
uv run arachne cat last

Reuse a good graph

uv run arachne graphs
uv run arachne rerun <graph-id> --goal "A related topic"

Recover from failure

uv run arachne ls -n 10
uv run arachne resume <session-id>
uv run arachne cat <session-id>