wiff — Claude Code MCP server: multi-agent workflows
Runs multi-agent workflows written as plain JavaScript, survives a crash and picks up where it stopped.
claude mcp add wiff -- npx -y @xxxoooxoxo/wiffWhat wiff does
wiff moves orchestration out of the chat and into a script. You write JavaScript with agent(), parallel() and pipeline(), and a local daemon executes it in the background. Every step lands in a journal, so after a failure finished agents come back from cache instantly instead of being paid for twice. An agent interrupted mid-turn restarts with a digest of its previous attempt.
Child agents can run on Codex, Claude, Cursor or Kimi, and any MCP client — Codex, Claude, Cursor, a cron job — can start, watch, resume or cancel the same run. The stdio bridge is disposable, the daemon is not, so killing the launching process leaves the workflow alive. Writing agents get isolation: "worktree" for a detached git worktree each.
Node.js 22 or newer is required. Preferences go in ~/.wiff/config.json, with project overrides in <cwd>/.wiff/config.json. A rejected agent fails the whole workflow unless you call parallelSettled() explicitly — no silent null standing in for a result.
What it helps with
- fan a file audit out across parallel agents
- resume a run after a daemon crash without re-running finished agents
- keep parallel writes apart with separate git worktrees
- set one model and effort policy for workflow stages
- hold a stage until a condition is met with
/goal
Example prompts for the agent
- Write
audit.jsthat audits the files inargs.filesfor auth bugs in parallel - Run the workflow and show me the run status
- Resume the interrupted run by its id
How to install wiff
Platform CLI
claude mcp add wiff -- npx -y @xxxoooxoxo/wiffPlatform CLI
codex mcp add wiff -- npx -y @xxxoooxoxo/wiffConfig file
{
"mcpServers": {
"wiff": {
"command": "npx",
"args": [
"-y",
"@xxxoooxoxo/wiff"
]
}
}
}Config file
{
"servers": {
"wiff": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@xxxoooxoxo/wiff"
]
}
}
}Platform CLI
gemini mcp add wiff npx -y @xxxoooxoxo/wiffStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about wiff
How do I install wiff in Claude Code?
Run claude mcp add wiff -- npx -y @xxxoooxoxo/wiff. That registers the server as a stdio MCP bridge in Claude.
What does wiff do?
It executes JavaScript multi-agent workflows through a local daemon. Runs are journaled, outlive the client that started them, and resume without replaying completed agents.
Which agents can wiff drive?
Child agents run on Codex, Claude, Cursor or Kimi. Any MCP client can start and resume the same runs.
