From 091ae4959e007a714b13d1fa7ad73ed4018dd175 Mon Sep 17 00:00:00 2001 From: slaguru666 Date: Wed, 15 Jul 2026 21:14:05 +0100 Subject: [PATCH] Correct Codex CLI notes in CLAUDE.md: verify binary/auth, document codex-ops-kit config --- CLAUDE.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/CLAUDE.md b/CLAUDE.md index ea861a1..fc53abb 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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 ""` (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 `.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 ""` (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`.