OpenParable
Skip to content
← Back to skills

Wanman CLI

Productivity
wanman-cli

Wanman CLI is an Agent Skill for productivity published in the chekusu/wanman repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

wanman CLI command reference — inter-agent communication, task management, artifact storage

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/chekusu/wanman/blob/HEAD/packages/core/skills/wanman-cli/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/wanman-cli, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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

CommandDescription
wanman send <agent> "<message>"Send a normal message
wanman send <agent> "<message>" --steerUrgent 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 recvReceive 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

VariableDescription
WANMAN_AGENT_NAMEYour agent name (set automatically)
WANMAN_URLSupervisor address (default http://localhost:3120)