ChatGPT Pro planner
Plan with ChatGPT Pro, execute with Claude or Codex. repo-harness gives ChatGPT read-only access to your registered repo — workflow files plus the repo tree, search, and file contents — through a local MCP sidecar, while writes stay scoped to workflow artifacts (plans, sprints, contracts, handoffs). The planner reads real state without touching source.
Start the planner sidecar
Section titled “Start the planner sidecar”repo-harness mcp setup chatgpt --repo .repo-harness mcp serve --transport http \ --host 127.0.0.1 --port 8765 --profile plannerConnect the printed /mcp URL as a ChatGPT Connector. The planner profile is
read-only over the registered repo, and writes are limited to workflow artifacts.
Hand a plan to the executor
Section titled “Hand a plan to the executor”repo-harness mcp prepare-goal \ --prd plans/prds/auth.prd.md \ --sprint plans/sprints/auth.sprint.md# › .ai/harness/handoff/codex-goal.mdSafety boundary
Section titled “Safety boundary”The planner profile makes hard guarantees:
- no source writes,
- no arbitrary shell,
- no default runner,
- separate from your API quota.
It is plan-and-review only — Codex or Claude stays the executor.
Full setup
Section titled “Full setup”For the complete Connector flow — OAuth, tunnel endpoints, Codex stdio, the opt-in dev runner, and troubleshooting — see MCP Connector. To drive ChatGPT Web through Oracle instead of the API, see the ChatGPT browser engine.