From bwoc
Coordinate the BWOC agent fleet from Claude Code. Use when the user wants to list/inspect BWOC agents, delegate or send work to a fleet member, run a headless task on an agent, manage Saṅgha teams or their shared task list, or read workspace deep-memory. Wraps the `bwoc` CLI (shell-out, no server).
How this skill is triggered — by the user, by Claude, or both
Slash command
/bwoc:bwoc-fleetThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill teaches when and how to drive the **BWOC** agent fleet from Claude Code. Every
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.
Reach for the fleet when the user asks to:
bwoc list, bwoc status.bwoc send or bwoc run.bwoc team, bwoc task.bwoc memory.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
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).
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
list, status, *-list, memory show/search) when exploring.send, run, task add/claim/complete, team create/retire, and memory put/rm
as mutating — confirm intent before firing them against the live fleet.--workspace <path> (or BWOC_WORKSPACE) when the
cwd is not inside the intended workspace.Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub bemindlabs/bwoc-plugin-claude --plugin bwoc