Skip to content

docs: add OpenAI Codex as a configure host #347

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
hyoshi merged 1 commit into from
Jun 27, 2026
Merged

docs: add OpenAI Codex as a configure host #347

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions docs/getting-started.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -236,6 +236,16 @@ The MCP server picks up the credentials from `~/.mureo/credentials.json` automat

Same as Desktop chat — Cowork uses the same MCP entry. After `install-desktop` + `auth setup`, **connect the workspace folder** in Cowork (`~/mureo`) so the agent can also see local files when needed.

### D. Auth in OpenAI Codex

```bash
pip install mureo
mureo setup codex # wires the MCP server + credential-guard hook + skills into ~/.codex
mureo configure # browser UI: OAuth + credentials (or do it all here by picking the "OpenAI Codex" host)
```

Restart Codex — the CLI, IDE extension, and desktop app all share `~/.codex/config.toml`, so one setup covers all three. Then run a workflow ("run a daily check", or `$daily-check` via the `/skills` picker). The MCP server reads credentials from `~/.mureo/credentials.json` automatically.

## Step 3 — Verify

```bash
Expand Down Expand Up @@ -271,6 +281,7 @@ Skill availability by host:
| Claude Code | `/daily-check`, `/budget-rebalance`, … | All 11 operational skills + 6 foundation skills available locally |
| Claude Desktop chat | natural language ("run a daily check") | Skills must be registered to claude.ai (manual upload or marketplace) |
| Cowork | natural language | Same registration story as chat |
| OpenAI Codex | `$daily-check` / the `/skills` picker, or natural language | Skills install to `~/.codex/skills` (CLI / IDE / desktop app share them) |

---

Expand Down
14 changes: 14 additions & 0 deletions docs/mcp-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,20 @@ Add to `.cursor/mcp.json` in your project root:
}
```

### OpenAI Codex

Codex reads MCP servers from `~/.codex/config.toml` (**TOML**, not JSON) — shared
across the Codex CLI, IDE extension, and desktop app. The easiest path is
`mureo setup codex` (or `mureo configure` → pick the **OpenAI Codex** host),
which writes a tagged `[mcp_servers.mureo]` block and preserves the rest of the
file. To wire it by hand:

```toml
[mcp_servers.mureo]
command = "python"
args = ["-m", "mureo.mcp"]
```

### Using a Virtual Environment

If mureo is installed in a virtual environment, use the full path to the Python interpreter:
Expand Down