bwoc-fleet

BWOC Fleet Coordination

This skill teaches when and how to drive the BWOC agent fleet from Claude Code. Every capability is a thin wrapper over the bwoc CLI — there is no server or daemon to manage. Always discover exact flags with bwoc <verb> --help if unsure, and quote user-supplied values.

When to use

Reach for the fleet when the user asks to:

• See who is in the fleet, or check an agent's health → bwoc list, bwoc status.
• Hand a unit of work to a specific specialist agent → bwoc send or bwoc run.
• Coordinate several agents around a shared backlog → bwoc team, bwoc task.
• Recall prior decisions/context the workspace has stored → bwoc memory.

Read-only first (safe to run anytime)

bwoc list                      # registered agents (table); add --json, --status, --backend, --running
bwoc list --names-only         # bare ids, good for scripting loops
bwoc status <agent>            # one agent's health + identity snapshot
bwoc status --all              # full detail for every agent
bwoc team list                 # Saṅgha teams with member + task counts
bwoc task list <team>          # a team's shared task list
bwoc memory list               # workspace memory entries
bwoc memory show <name>        # read one entry (or --all)
bwoc memory search "<query>"   # case-insensitive substring search

Delegating work

• bwoc send <agent> "<message>" — append a message to the agent's inbox; fire-and-forget. The agent picks it up on its next run. Use for nudges, context, async hand-offs.
• bwoc run <agent> --task "<prompt>" — run a single task headless and capture the result synchronously. Use when you need the answer back now. Add --timeout <seconds> for long runs and --json for structured output.
• @agent-<id> — the re-exported sub-agents (see agents/) let Claude Code delegate to a fleet member as a native sub-agent; each sub-agent itself shells out to bwoc.

Pick send for async/fan-out, run for a blocking one-shot, chat for an interactive hands-on session (it execs the backend CLI; surface it to the user rather than running it inside the non-interactive Bash tool).

Coordinating teams

bwoc team create <id> --members a,b,c     # form a Saṅgha team
bwoc task add <team> "<title>"            # add to the shared backlog (--deps, --requires-plan)
bwoc task claim <team> <task> --as <agent>      # a member claims a task
bwoc task complete <team> <task> --as <agent>   # claimant completes it

Safety

• Prefer read-only verbs (list, status, *-list, memory show/search) when exploring.
• Treat send, run, task add/claim/complete, team create/retire, and memory put/rm as mutating — confirm intent before firing them against the live fleet.
• Always quote message/task/title/query arguments so multi-word values stay intact.
• Target a specific workspace with --workspace <path> (or BWOC_WORKSPACE) when the cwd is not inside the intended workspace.