codex-docslisted

# Codex Documentation (local mirror) The official Codex docs are mirrored at `~/codex-docs/` — a flat folder with ~80 `.md` files, auto-synced hourly from `developers.openai.com/codex`. ## How to look up answers No semantic-search tool is configured, so fall back to listing + grep: 1. **List or filter filenames** to find the relevant doc: ``` ls ~/codex-docs/ # see all topics ls ~/codex-docs/ | grep -i mcp # filenames mentioning MCP ``` 2. **Grep across the corpus** to find specific terms: ``` grep -l -i "AGENTS.md" ~/codex-docs/*.md # files mentioning AGENTS.md grep -i "sandbox_mode" ~/codex-docs/*.md # exact term lookup ``` 3. **Read the file** fully (or with offset/limit for large ones) once you know which doc has the answer. ## When to read the full file Fetch the raw file when grep results do not contain the exact detail needed — typical reasons: - exact TOML schema or full `config.toml` key list - precise CLI flag spelling or option list - the full table of an env-var / settings / hook event reference - the complete catalog of slash commands To read the raw file, use the standard read tooling with the absolute path: ``` Read("/Users/<you>/codex-docs/<filename>.md") ``` ## File naming The mirror flattens the URL path with `__` as the separator: - `developers.openai.com/codex/quickstart` → `quickstart.md` - `developers.openai.com/codex/app/automations` → `app__automati