Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ Dispatch is a skill (`/dispatch`) for Claude Code that decomposes large coding t
- **`.dispatch/` directory**: Ephemeral task state. Delete it to clean up.
- **Config location**: `~/.dispatch/config.yaml` (auto-generated on first run).
- **Skill source**: `skills/dispatch/SKILL.md` is the canonical skill definition. Do NOT modify it for docs changes.
- **Warm-up invocation**: Running `/dispatch` with no arguments (or just the word "dispatch") reads `~/.dispatch/config.yaml` and stops — it does not proceed to task planning. Used to pre-load config at session start.
- **Multi-model resolution**: If multiple models are named in a single prompt, dispatch uses the last one mentioned. If no model is mentioned, dispatch confirms the default model with the user before proceeding.
- **Failure recovery**: If a worker's model fails (auth error, quota, CLI unavailable), the user is prompted for an alternative and config is updated to avoid the same failure again.

Expand Down
12 changes: 12 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -121,6 +121,18 @@ your session wrote five checklists and is idle. Dispatch more work or say
"status" anytime.
```

## Best practice: warm up at session start

Run `/dispatch` with no arguments at the beginning of a session to pre-load your config:

```
/dispatch
```

This reads `~/.dispatch/config.yaml` into the dispatcher's context so subsequent dispatches are faster and don't need confirmation prompts. It's a good habit to add as a [Claude Code memory](https://docs.anthropic.com/en/docs/claude-code/memory) so you remember to do it each session:

> "Run /dispatch at the start of each session to warm up the config."

## Setup

On first run, `/dispatch` auto-detects your CLIs (`claude`, `agent`, `codex`), discovers available models, and generates `~/.dispatch/config.yaml`. No manual config needed.
Expand Down