Command Reference

Task management

Command	Description
wg add <title>	Create a new task. Supports --after, --verify, --model, --skill, --hours, --deliverable, and more.
wg edit <id>	Modify an existing task's fields — title, description, tags, skills, model, verify criteria, etc.
wg done <id>	Mark task complete. Use --converged to stop a cycle.
wg fail <id>	Mark task as failed with --reason.
wg abandon <id>	Mark task as abandoned (terminal state).
wg retry <id>	Reset a failed task back to open.
wg claim <id>	Claim a task for work (sets in-progress).
wg unclaim <id>	Release a claimed task back to open.
wg reclaim <id>	Transfer a task from one agent to another.
wg pause <id>	Pause a task — coordinator skips it.
wg resume <id>	Resume a paused task.
wg approve <id>	Approve a task pending validation.
wg reject <id>	Reject a task pending validation with feedback.
wg assign <task> <agent>	Assign an agent identity to a task.
wg add-dep <task> <dep>	Add a dependency edge.
wg rm-dep <task> <dep>	Remove a dependency edge.
wg wait <id>	Park a task until a condition is met.
wg publish <id>	Publish a draft task (validates deps, resumes subgraph).
wg log <id> "msg"	Add a progress note. Use --list to view.
wg artifact <id> <path>	Record a file artifact on a task.

Query commands

Command	Description
wg show <id>	Full task details — description, logs, timestamps, deps, model.
wg list	List tasks. Filter with --status, --tag, --skill.
wg ready	Tasks with no unfinished blockers.
wg viz	ASCII dependency graph. Use wg viz <id> to show a subtree.
wg status	Summary statistics — counts by status.
wg cycles	Inspect detected cycles with iteration counts.
wg context	View the current task's full context.
wg quickstart	Session orientation — shows project state and next steps.

Service commands

Command	Description
wg service start	Start the background daemon.
wg service stop	Stop daemon. --kill-agents to also kill agents.
wg service status	Daemon PID, uptime, agent summary.
wg service reload	Re-read config.toml without restarting.
wg service restart	Graceful stop then start.
wg service pause	Pause coordinator (no new spawns).
wg service resume	Resume coordinator.
wg service install	Generate systemd user service file.

Agent commands

Command	Description
wg agents	List agents. --alive, --dead, --working, --idle.
wg spawn <task>	Manually spawn an agent for a task.
wg kill <agent>	Kill an agent (unclaims its task). --force for SIGKILL.
wg dead-agents	Check for dead agents. --cleanup, --purge.

Agency commands

Command	Description
wg agency init	Seed starter roles and tradeoffs.
wg agency stats	Performance leaderboard, synergy matrix.
wg role add <name>	Create a role with --outcome, --skill.
wg role list	List all roles.
wg role show <id>	Show role details.
wg tradeoff add <name>	Create a tradeoff with --accept, --reject.
wg tradeoff list	List all tradeoffs.
wg agent create <name>	Create an agent with --role, --tradeoff.
wg agent list	List all agents.
wg evaluate run <task>	LLM-based evaluation of completed task.
wg evaluate show	View evaluation history.
wg evolve run	Evolve agency using performance data.

Configuration

Command	Description
wg config --list	Show merged config (source: global, local, or default).
wg config --max-agents <n>	Set max parallel agents.
wg config --model <m>	Set default model.
wg config --executor <e>	Set executor type.
wg config --auto-assign true	Enable automatic agent assignment.
wg config --auto-evaluate true	Enable automatic evaluation.
wg config --flip-enabled true	Enable FLIP scoring.
wg config --global	Show/set global config only.
wg config --local	Show/set project config only.
wg setup	Interactive setup wizard (run once after install).

Model management

Command	Description
wg model list	Show all models (built-in + user-defined).
wg model add <name>	Add a model with --provider, --model-id.
wg model set-default <m>	Set default dispatch model.
wg model set --role <r> <m>	Per-role model routing.
wg key set <provider>	Configure a provider's API key.
wg key check	Validate key availability.

Communication

Command	Description
wg msg send <task> "text"	Send a message on a task.
wg msg read <task>	Read messages for a task.

Utilities

Command	Description
wg init	Initialize a workgraph in the current directory.
wg tui	Interactive terminal dashboard.
wg watch	Watch task graph for changes.
wg gc	Garbage collect completed/abandoned tasks.
wg sweep	Clean up orphaned tasks.
wg skill install	Install the Claude Code skill.
wg skill list	List available skills.
wg func list	List reusable workflow functions.
wg func apply <id>	Instantiate a workflow function.

Run wg --help or wg <command> --help for full details on any command.