Content
# Fable Orchestrator Skill Bundle
This repository packages a local orchestration workflow where Codex can consult a stronger Claude Fable advisor during substantial work, and Claude Code can use an `/orchestrate` command to plan, dispatch, and review implementation tasks.
The bundle contains:
- `fable-advisor-mcp/`: an MCP server exposing an `advisor` tool for Codex.
- `codex/AGENTS.md`: guidance for when and how Codex should call the advisor.
- `codex/config-snippet.toml`: a Codex MCP configuration snippet.
- `claude/commands/orchestrate.md`: a Claude Code command for Fable-led orchestration.
- `INSTALL.md`: device setup and verification notes.
## Install
Prerequisites:
- Node.js 18 or newer.
- `pnpm`.
- Claude Code CLI installed and logged in.
- Codex CLI installed and logged in.
Build and test the MCP server:
```bash
cd fable-advisor-mcp
pnpm install --frozen-lockfile
pnpm build
npm test
```
Register the MCP server with Codex by copying `codex/config-snippet.toml` into your Codex configuration and replacing `<PATH-TO>` with the local path where this repository lives.
Install the Codex guidance by copying or merging `codex/AGENTS.md` into your Codex global guidance file.
Install the Claude Code command:
```bash
mkdir -p ~/.claude/commands
cp claude/commands/orchestrate.md ~/.claude/commands/orchestrate.md
```
## Verify
After building the MCP server, start a fresh Codex session and call the `advisor` tool with a small test prompt. The tool should return advice or a clear `Advisor error (...)` message that lets the executor continue.
For the Claude Code command, start a fresh Claude Code session and run `/orchestrate <task>` against a small local task. Confirm that it plans, dispatches implementation work, and reviews the result.
## License
License is TBD. Add a license before publishing if distribution rights need to be explicit.
