Skip to main content

Current Version

Version 2.0.0

Release Date: February 22, 2026 Major Changes:

New Config Schema

Introduced backends, models, and aliases structure for better multi-model support

IPC Protocol

Workers can now ask questions back without losing context via the IPC directory system

Multi-Backend Support

Support for Claude Code, Cursor, and Codex CLIs as worker backends

Auto Model Discovery

First-run setup auto-detects available CLIs and models
Core Features:
  • Checklist-based planning: Tasks decomposed into verifiable checklist items
  • Background worker agents: Non-blocking execution with fresh context windows
  • Monitor system: Detects questions and completion without polling
  • Model aliases: Create named shortcuts with optional role prompts
  • Parallel task execution: Multiple workers run concurrently
  • Proactive recovery: Handles CLI failures and auth errors gracefully
Config System:
  • Backend-agnostic command construction
  • Auto-routing Claude models to claude backend
  • Auto-routing OpenAI models to codex backend when available
  • Backward compatibility with old config format
  • Model-specific command templates
IPC Features:
  • Atomic file writes via temp + mv pattern
  • Sequence-numbered question/answer pairs
  • Worker context preservation across questions
  • Timeout handling with fallback to context dump
  • Startup reconciliation for lost questions
Worker Capabilities:
  • Read and update plan files
  • Ask clarifying questions
  • Mark items as done, blocked, or errored
  • Write output artifacts
  • Handle sequential dependencies
Dispatcher Features:
  • Config file management
  • Task planning and spawning
  • Progress tracking
  • IPC question/answer relay
  • Error detection and reporting
  • Multiple task coordination

Updating

npx skills update
This updates all installed skills to their latest versions. Check what’s changed first:
npx skills check

Manual Update (Local Clone)

If your .claude/skills/dispatch is a symlink to a local git checkout:
cd /path/to/your/dispatch
git pull
Changes are picked up immediately — Claude Code hot-reloads skills from disk.

Version History

This is a new documentation site. Full version history is maintained in the source repository.
For detailed commit history and pull requests, see:

Breaking Changes

Version 2.0.0

Config Format Change: Old format (still supported):
default: opus
agents:
  opus:
    command: "claude -p --dangerously-skip-permissions"
New format (recommended):
default: opus

backends:
  claude:
    command: >-
      env -u CLAUDE_CODE_ENTRYPOINT -u CLAUDECODE
      claude -p --dangerously-skip-permissions

models:
  opus: { backend: claude }
Migration: Run /dispatch "migrate my config" to upgrade automatically.

Planned Features

The following features are under consideration for future releases:
  • Worker resource limits (timeout, max tokens)
  • Task priority and scheduling
  • Worker result caching
  • Custom backend definitions
  • Enhanced error reporting with structured logs
  • Task history and replay
Feature requests and suggestions are welcome! Open an issue on GitHub.

License

Dispatch is released under the MIT License. See the LICENSE file in the source repository for full details.

Build docs developers (and LLMs) love