agent-dispatcher

# Agent Dispatcher

[](https://github.com/nahid-sparktales/agent-dispatcher/actions/workflows/ci.yml)
[](https://github.com/nahid-sparktales/agent-dispatcher/actions/workflows/security.yml)

**Repository retrieval and context for Claude Code and Codex.**

Agent Dispatcher finds the code a task needs using symbols, source text, code relationships,
and Git history. It assembles relevant source excerpts, pairs the work with specialist
guidance, and makes verification explicit. Use it to explore a repository, debug a failure,
build a feature, or review a change.

<!-- counts:start -->**27 roles · 79 local skills · 31 external skills · 8 recipes · 19 MCP servers · 50 detection signals**<!-- counts:end -->

[Quick start](#quick-start) · [Usage](#everyday-use) · [Catalog](docs/catalog.md) ·
[Documentation](#documentation) · [Changelog](CHANGELOG.md)

## Quick start

You need an installed, authenticated Claude Code or Codex, Git, and Python 3.10+.
The helpers use Python's standard library. Use macOS, Linux, or a Unix environment such as WSL;
native Windows installation is not covered. Normal use needs no additional API key.

### Codex

Run in your terminal:

```bash
git clone https://github.com/nahid-sparktales/agent-dispatcher.git
cd agent-dispatcher
python3 install_codex.py
```

Start a new Codex task in your project and invoke the skill:

```text
$agent-dispatcher Find why the tests are failing, fix the cause, and verify the fix.
```

This installs one skill at `~/.agents/skills/agent-dispatcher/`, with roles and supporting
guides loaded as needed. See [Codex setup](adapters/codex/README.md) for updates and uninstall.

### Claude Code

Run in your terminal:

```bash
claude plugin marketplace add nahid-sparktales/agent-dispatcher
claude plugin install agent-dispatcher@agent-d