wanman-agent-matrix — Claude Code skill: local agent matrix
A skill that documents wanman, the local runtime that runs several Claude or Codex agents and links them through a supervisor.
npx skills add reason-machines/trending-skills --skill wanman-agent-matrix -a claude-codeWhat wanman-agent-matrix does
wanman-agent-matrix is a reference skill for wanman, an open-source local agent matrix runtime. A supervisor process runs on your machine and talks to the CLI over JSON-RPC 2.0 on HTTP. Every agent gets its own worktree and its own $HOME, so your working directory and shell profile stay untouched.
The skill covers the CLI surface: wanman takeover <path> takes over a git repo, wanman run <goal> spins up a matrix for a single goal, wanman send and wanman recv move messages between agents, and wanman watch streams activity live. Other command groups handle a shared task pool, initiatives, change capsules, artifacts, hypotheses and shared context. Agents are declared in .wanman/config.json with a lifecycle of 24/7, on-demand or idle_cached.
Building from source needs Node.js 20+, pnpm 9+, git and a logged-in Claude or Codex CLI. The idle_cached lifecycle keeps the Claude session_id alive through claude --resume, so pairing it with the codex runtime fails at startup — worth deciding on WANMAN_RUNTIME before you configure agents. The supervisor address comes from WANMAN_URL and defaults to http://localhost:3120.
What it helps with
- run several Claude agents over one repository
- hand out work through a shared task pool
- message an agent and interrupt it with
--steer - follow supervisor and agent activity live
- keep agents isolated by worktree and
$HOME
Example prompts for the agent
- Set up a wanman agent matrix for this repo and list the agents
- Create a task in the shared pool and assign it to the dev agent
- Escalate a message to the ceo agent with
wanman escalate
How to install wanman-agent-matrix
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill wanman-agent-matrix -a claude-code2Manually: put the files in place
~/.claude/skills/wanman-agent-matrix/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/wanman-agent-matrix/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill wanman-agent-matrix -a codex2Manually: put the files in place
.agents/skills/wanman-agent-matrix/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill wanman-agent-matrix -a cursor2Manually: put the files in place
.cursor/skills/wanman-agent-matrix/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills wanman-agent-matrix2Manually: put the files in place
.github/skills/wanman-agent-matrix/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill wanman-agent-matrix -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/wanman-agent-matrixManually: put the files in place
.devin/skills/wanman-agent-matrix/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill wanman-agent-matrix -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about wanman-agent-matrix
How do I install wanman-agent-matrix in Claude Code?
Run npx skills add reason-machines/trending-skills --skill wanman-agent-matrix -a claude-code. The skill lands in ~/.claude/skills/wanman-agent-matrix/SKILL.md.
What does wanman-agent-matrix do?
It documents wanman: CLI commands, agent configuration, environment variables and workflows for the local agent matrix.
What do I need to run wanman?
Node.js 20+, pnpm 9+, git and a logged-in Claude or Codex CLI. The supervisor address is set through WANMAN_URL.