CLI Guide

The CLI is intentionally small. It exists to inspect local event logs and graph projections.

Commands

arcagent-state init
arcagent-state events
arcagent-state graph
arcagent-state node <id>
arcagent-state lineage <id>
arcagent-state lineage <id> --markdown
arcagent-state goal create <id> <title> [summary]
arcagent-state goal list
arcagent-state goal show <id>
arcagent-state goal status <id> <open|in-progress|satisfied|abandoned|blocked|stale>
arcagent-state patch list
arcagent-state patch show <id>
arcagent-state patch promote <id>
arcagent-state fork create <id> [event-id]
arcagent-state replay

When running from source, prefix commands with Cargo:

cargo run --bin arcagent-state -- graph

Event log path

The default event log is:

.arcagent-state/events.jsonl

Set arcagent_STATE_EVENTS to use another path:

arcagent_STATE_EVENTS=.arc/state/events.jsonl cargo run --bin arcagent-state -- events

Common local flow

Initialize:

cargo run --bin arcagent-state -- init

Inspect raw events:

cargo run --bin arcagent-state -- events

Inspect projected graph:

cargo run --bin arcagent-state -- graph

Print lineage:

cargo run --bin arcagent-state -- lineage patch_42 --markdown

List patches:

cargo run --bin arcagent-state -- patch list

Create a goal:

cargo run --bin arcagent-state -- goal create goal_retry "Make retry reliable"

Update goal status:

cargo run --bin arcagent-state -- goal status goal_retry in-progress

Create a fork at an event:

cargo run --bin arcagent-state -- fork create fork_before_patch event_123

Show one patch:

cargo run --bin arcagent-state -- patch show patch_42

Current limitation

The CLI is still intentionally small. Use the Rust API for full behavior/policy/pack flows and use the CLI for local inspection and simple goal/patch/fork operations.