Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (odd-flow) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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

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