fable-orchestrator README

The project's README from github.com/codejunkie99/fable-orchestrator. As one markdown file: README.md.

Fable orchestrator

Fable is a small, local-first routing skill for Codex. Claude Fable 5.1 plans and adjudicates; it does not write code or own the workspace. Codex remains the runtime and delegates bounded implementation work to OpenCode Go agents:

The skill consumes the callable opencode-go/ and opencode-go-responses/ agents supplied by Codex Router. It does not ship a proxy, dashboard, model catalog, credential store, or API key. Configure OpenCode Go once in the router, then restart Codex after changing provider or agent definitions.

Fable orchestrator: planning, implementation, and verification

Repository layout

skill/fable/
├── SKILL.md
├── agents/openai.yaml
└── scripts/ask_fable.sh
assets/fable-orchestrator.svg
install.sh
tests/test_skill.sh

The three files under skill/fable/ are the installable skill. ask_fable.sh is executable and invokes Claude Code's local fable alias with no session persistence. The packet passed to it must contain decisions and workspace facts only; never put credentials in a packet.

Install

From this repository:

./install.sh --dry-run
./install.sh --copy

--dry-run prints the exact destination and copy operations without creating files. --copy installs to ~/.codex/skills/fable, creates only the required directories, and is safe to run again. Use --target DIR to select another skills directory:

./install.sh --copy --target "$PWD/.local/codex/skills"

The installer reads only this repository and the destination path. It never reads, creates, or modifies credentials. Start a new Codex task after changing the provider or agent definitions.

Use

Invoke the skill with an objective:

$fable build the feature

Fable returns a bounded graph. Codex validates the graph, starts ready workers in parallel when useful, collects their evidence, verifies the result, and asks Fable to adjudicate when the task needs another decision. Every implementation node must use GPT-5.6 Luna or DeepSeek V4 Flash. If neither allowed OpenCode Go route is callable, the workflow reports the blocker instead of inventing a model.

Test

Run the repository's dependency-light checks:

tests/test_skill.sh

The test checks shell syntax, the copied source files, required routing strings, basic YAML structure, optional xmllint XML validation, SVG safety constraints, a temporary-home dry run, an idempotent copy, and common credential-shaped strings. It does not require PyYAML or a live Claude login.

License

MIT. See LICENSE.

fable-orchestrator (codejunkie99/fable-orchestrator)

Searching Database…

615 ·GitHub
Fable-orchestrator
Что это?Fable — локальный (local-first) скилл маршрутизации для Codex, который планирует и судит задачи, передавая ограниченные объёмы имплементации агентам OpenCode Go: GPT-5.6 Luna для обычной работы и DeepSeek V4 Flash для циклов и высокопроизводительных итераций.
Это отдельное приложение или скилл для существующего инструмента?Это скилл для Codex, а не отдельное приложение: три файла из skill/fable/ копируются в папку скиллов Codex, рантаймом остаётся Codex, а Fable только планирует и выносит вердикты, не пиша код.
Что нужно настроить до использования Fable?Нужен Codex с агентами OpenCode Go (GPT-5.6 Luna и DeepSeek V4 Flash), настроенными в Codex Router, плюс локальный алиас fable из Claude Code, который вызывает askfable.sh.
Что будет, если нужные модели недоступны?Если ни GPT-5.6 Luna, ни DeepSeek V4 Flash недоступны через OpenCode Go, Fable сообщит о блокере, а не подставит другую модель; после изменения провайдера или описаний агентов нужно перезапустить Codex.
Трогает ли Fable мои учётные данные?Нет — скилл и его установщик никогда не читают, не создают и не изменяют учётные данные, а любой передаваемый ему пакет должен содержать только решения и факты о рабочем пространстве.
Зачем две разные модели имплементации вместо одной?GPT-5.6 Luna занимается обычной имплементацией, а DeepSeek V4 Flash зарезервирован для циклов, повторяющихся итераций и высокопроизводительной работы, так что Fable направляет каждую задачу наиболее подходящей модели.
Как запустить тесты?Облегчённый тестовый набор репозитория проверяет синтаксис shell, скопированные исходники, обязательные строки маршрутизации, базовую структуру YAML, опциональную валидацию XML/SVG, пробный запуск во временном домашнем каталоге, идемпотентность копирования и сканирует строки, похожие на учётные данные, — без PyYAML и без живого входа в Claude.
Как Fable решает, что задаче нужен ещё один вердикт?Codex валидирует граф, который вернул Fable, параллельно запускает готовых воркеров, собирает их доказательства, проверяет результат и обращается к Fable за вердиктом только тогда, когда задаче нужно новое решение.
What are similar projects?pstack-claude, council-of-high-intelligence, ordewell, agents, ruflo, foreman, pstack, codify
Which topics is it in?bash, agent-skill, gpt, harness, opencode, orchestration, agent-orchestration, cli-tool, skill, shell, deepseek, agentic-ai
Creator
codejunkie99
Size
<0.1 MB
Stars
615
Updated
CommitSep 04
Age
1mo
Commits · 90 Days