Correct Codex CLI notes in CLAUDE.md: verify binary/auth, document codex-ops-kit config

This commit is contained in:
2026-07-15 21:14:05 +01:00
parent a767e3ef55
commit 091ae4959e
+5 -1
View File
@@ -27,7 +27,11 @@ Discard:
## Available Tools & Integrations
- **GitHub MCP** — use for repo operations, PRs, issues, code search. Always prefer this over manual `gh` CLI when available.
- **Graphiti MCP** — knowledge graph memory at `graphiti.timevans.uk`. Use `search_memory_facts` at session start to recall prior context. Use `add_memory` to persist important decisions, discoveries, and project state.
- **Codex CLI** — `@openai/codex` (binary `codex`) is installed and authenticated (ChatGPT login, creds in `~/.codex/auth.json`, per-machine and not synced). Use for delegating tasks or code review via the `codex@openai-codex` plugin (`/codex:*` commands) or directly: `codex exec "<prompt>"` (add `--skip-git-repo-check` outside a git repo). `install.sh` installs the CLI on each machine; run `codex login --device-auth` once per machine (SSH-friendly).
- **Codex CLI** — `@openai/codex` (binary `codex`). The binary and its auth are per-machine and not synced, so verify rather than assume — check `codex --version` and `codex login status`.
- Binary: `install.sh` installs it only when `npm` is already present, so a machine without Node gets nothing but a warning. Install Node first, then `npm install -g @openai/codex`.
- Auth: ChatGPT login, creds in `~/.codex/auth.json`. Only run `codex login --device-auth` (SSH-friendly) if `codex login status` says you are logged out — a valid `auth.json` may already exist even when the binary is missing.
- Config: `~/.codex/config.toml` plus `<name>.config.toml` per profile, generated by the `codex-ops-kit` repo (`~/codex-ops-kit`, `slaguru666/codex-ops-kit`) — edit the templates there, not the live files, or the next install overwrites them. Profiles: `codex --profile economy|balanced|deep`; plain `codex` uses balanced defaults.
- Use via the `codex@openai-codex` plugin (`/codex:*` commands) or directly: `codex exec "<prompt>"` (add `--skip-git-repo-check` outside a git repo).
- The user runs Claude Code on multiple machines: `timevans-MINI-S` (Linux, Zorin OS 18.1; static LAN IP `192.168.1.6`, key-only SSH — see the `infra-minis-remote-access` memory) and a Mac Mini (`tims-mac-mini-local`). Check the hostname to know which one you're on.
- The user adds `$HOME/bin` to PATH in `.bashrc`.