pyro-mcp/examples/codex_mcp.md
Thales Maciel 899a6760c4 Add host bootstrap and repair helpers
Add a dedicated pyro host surface for supported chat hosts so Claude Code, Codex, and OpenCode users can connect or repair the canonical MCP setup without hand-writing raw commands or config edits.

Implement the shared host helper layer and wire it through the CLI with connect, print-config, doctor, and repair, all generated from the same canonical pyro mcp serve command shape and project-source flags. Update the docs, public contract, examples, changelog, and roadmap so the helper flow becomes the primary onramp while raw host-specific commands remain as reference material.

Harden the verification path that this milestone exposed: temp git repos in tests now disable commit signing, socket-based port tests skip cleanly when the sandbox forbids those primitives, and make test still uses multiple cores by default but caps xdist workers to a stable value so make check stays fast and deterministic here.

Validation:
- uv lock
- UV_OFFLINE=1 UV_CACHE_DIR=.uv-cache make check
- UV_OFFLINE=1 UV_CACHE_DIR=.uv-cache make dist-check
2026-03-13 16:46:29 -03:00

988 B

Codex MCP Setup

Recommended profile: workspace-core.

Preferred helper flow:

pyro host connect codex
pyro host doctor

Package without install:

codex mcp add pyro -- uvx --from pyro-mcp pyro mcp serve
codex mcp list

Run that from the repo root when you want the first workspace_create to start from the current checkout automatically.

Already installed:

codex mcp add pyro -- pyro mcp serve
codex mcp list

If Codex launches the server from an unexpected cwd, pin the project explicitly:

pyro host connect codex --project-path /abs/path/to/repo
codex mcp add pyro -- uvx --from pyro-mcp pyro mcp serve --project-path /abs/path/to/repo

If the local config drifts later:

pyro host repair codex

Move to workspace-full only when the chat truly needs shells, services, snapshots, secrets, network policy, or disk tools:

codex mcp add pyro -- uvx --from pyro-mcp pyro mcp serve --profile workspace-full