odd-flow

Agent orchestration for Claude Code.

odd-flow is a CLI and MCP tool package for coordinating multi-agent coding workflows. It bundles swarm orchestration, memory tools, hooks, and MCP integrations into a single package you can install locally or run via npx.

What this package is for

Use odd-flow if you want to:

• run a local MCP server that exposes orchestration tools to Claude Code
• coordinate multiple agents working on the same task
• persist useful patterns and retrieve them with semantic memory search
• add hooks, task routing, and session management to your coding workflow

This is the end-user package. If you are looking for lower-level building blocks, see the companion packages:

• @darrenjcoxon/odd-flow-mcp for the standalone MCP server library
• @darrenjcoxon/odd-flow-shared for shared infrastructure and types

Install

Run without installing:

npx odd-flow

Install globally:

npm install -g odd-flow

Quick start

Register as an MCP server for Claude Code:

claude mcp add odd-flow -- npx -y odd-flow

Initialize a project and start using the CLI:

odd-flow init
odd-flow swarm init --topology hierarchical
odd-flow agent spawn -t coder --name my-agent
odd-flow memory store --key "pattern" --value "JWT refresh token rotation"
odd-flow memory search --query "authentication"

Core capabilities

• Swarm orchestration for multi-agent workflows
• Semantic memory storage and retrieval
• MCP server with orchestration tools
• Hooks and session management
• Task coordination and progress tracking
• Security-focused transfer and plugin tooling

Main commands

• init
• agent
• swarm
• memory
• task
• session
• hooks
• mcp
• doctor
• config

Run odd-flow --help or odd-flow <command> --help for command details.

Who should use this package

• developers using Claude Code who want local orchestration tools
• teams experimenting with multi-agent workflows
• users who want one installable package instead of wiring the lower-level libraries together manually

License

MIT