Support Codex OAuth login and add CLI setup docs

This commit is contained in:
Garfield
2026-05-11 10:39:24 -04:00
parent ffb67560b9
commit 6bf4cfd069
6 changed files with 458 additions and 113 deletions

58
CODEX_SETUP.md Normal file
View File

@@ -0,0 +1,58 @@
# Connecting Hermes MCP to Codex CLI
Hermes is exposed for Codex at:
```text
https://hermes.squaremcp.com/mcp
```
## Recommended setup
Add this block to your global Codex config at:
```text
~/.codex/config.toml
```
```toml
[mcp_servers.hermes]
url = "https://hermes.squaremcp.com/mcp"
```
If the file already exists, append or merge the block instead of replacing your other config.
## Example
```toml
[projects."/path/to/your/project"]
trust_level = "trusted"
[mcp_servers.hermes]
url = "https://hermes.squaremcp.com/mcp"
```
## Auth model
Hermes supports:
1. `x-api-key`
2. `?key=`
3. OAuth bearer tokens
Codex config currently uses the server URL block above. If your Codex build later exposes MCP header configuration directly, use your own live credential and do not commit it into this repo.
## Verify
After updating `~/.codex/config.toml`, restart Codex and check that the `hermes` MCP server is available in the tool space for the project.
## Current production endpoint
```text
https://hermes.squaremcp.com/mcp
```
## Related docs
1. [CLI agent setup](./AGENTS_CLI_SETUP.md)
2. [opencode setup](./OPENCODE.md)
3. [ChatGPT setup](./CHATGPT_SETUP.md)