/wanman-cli

name: wanman-cli
description: wanman CLI command reference — inter-agent communication, task management, artifact storage

wanman CLI

You are running inside the wanman Agent Matrix. Use the following CLI commands to collaborate with other agents.

Startup Protocol

On every startup, execute in order:

1. `cat ./CLAUDE.md` — Read your role guide 2. `wanman recv` — Check for pending messages 3. `wanman task list --assignee $WANMAN_AGENT_NAME` — View tasks assigned to you

Messages

| Command | Description | |---------|-------------| | `wanman send <agent> "<message>"` | Send a normal message | | `wanman send <agent> "<message>" --steer` | Urgent message (interrupts the target agent's current work) | | `wanman send human --type decision "<message>"` | Ask the human to make a decision | | `wanman send human --type blocker "<message>"` | Tell the human what is blocking progress | | `wanman recv` | Receive pending messages | | `wanman escalate "<message>"` | Escalate to the CEO agent |

**Note**: `--steer` forcefully interrupts the target agent's process and restarts it. Use only in urgent situations. Prefer explicit `--type decision|blocker` when sending to `human`, so the product can render the right card.

Tasks

wanman task create "<title>" --assign <agent> [--priority 1-10] [--after id1,id2] [--desc "<description>"]
wanman task list [--status <pending|in_progress|done|blocked>] [--assignee <agent>]
wanman task get <id>
wanman task update <id> --status <in_progress|blocked|done> [--result "<text>"]
wanman task done <id> "<result>"

• `--after`: Declare dependencies (comma-separated task IDs); the task will not execute until dependencies are complete
• `--priority`: 1 = highest, 10 = lowest
• `task done` is a shortcut for `task update --status done --result`

Artifacts (Structured Outputs)

wanman artifact put --kind <kind> --path "<domain>/<category>/<item>" \
  --source "<source>" --confidence <0-1> [--task <id>] [--file <path>] '<metadata json>'
wanman artifact list [--agent <a>] [--kind <k>]
wanman artifact get <id>

• `--file`: Store file contents in the database (version-controlled storage)
• `--source`: Information source, e.g., `web_search:site.com`, `estimate`, `official_data`
• `--confidence`: 0.3-0.5 (estimate) | 0.6-0.8 (data-backed) | 0.9+ (authoritative source)

Context (Cross-Agent Shared Key-Value Store)

wanman context set <key> "<value>"
wanman context get <key>

Used to share blueprints, summaries, and other information needed across agents.

Hypothesis Tracking

wanman hypothesis create "<title>" [--rationale "<text>"]
wanman hypothesis list [--status <proposed|active|validated|rejected>]
wanman hypothesis update <id> --status <validated|rejected> [--outcome "<text>"] [--evidence <artifact-ids>]

Agent Management

wanman agents                              # List all agents and states
wanman agents spawn <template> [name]      # Spawn a clone (e.g. feedback-2)
wanman agents destroy <name>               # Destroy a dynamic clone

Standard Workflow

1. `wanman task update <id> --status in_progress` 2. Do the work, write outputs to the `./output/` directory 3. `wanman task done <id> "completion description"` 4. `wanman send ceo "Task complete: <title>, output: output/<filename>"`

Environment Variables

| Variable | Description | |----------|-------------| | `WANMAN_AGENT_NAME` | Your agent name (set automatically) | | `WANMAN_URL` | Supervisor address (default `http://localhost:3120`) |