Thales Maciel
899a6760c4
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
48 lines
988 B
Markdown
48 lines
988 B
Markdown
# Codex MCP Setup
|
|
|
|
Recommended profile: `workspace-core`.
|
|
|
|
Preferred helper flow:
|
|
|
|
```bash
|
|
pyro host connect codex
|
|
pyro host doctor
|
|
```
|
|
|
|
Package without install:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
codex mcp add pyro -- pyro mcp serve
|
|
codex mcp list
|
|
```
|
|
|
|
If Codex launches the server from an unexpected cwd, pin the project
|
|
explicitly:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
pyro host repair codex
|
|
```
|
|
|
|
Move to `workspace-full` only when the chat truly needs shells, services,
|
|
snapshots, secrets, network policy, or disk tools:
|
|
|
|
```bash
|
|
codex mcp add pyro -- uvx --from pyro-mcp pyro mcp serve --profile workspace-full
|
|
```
|