This repo captures a portable configuration for OpenAI Codex CLI. It includes:
config/config.example.toml
: starter config (sanitize secrets before copying to~/.codex/config.toml
).config/AGENTS.md
: compiled rulebook.agent/rules
&agent/workflows
: rule files + playbooks.scripts/
: helper automation (build_agents_manifest.py
,startup_checklist.py
,auto_sync_agents.py
).
- Clone repo then copy folders into your Codex home (
~/.codex
on Linux/WSL,C:\Users\<you>\.codex
on Windows). - Update
config.example.toml
with real secrets / paths and rename toconfig.toml
. - Run
python3 scripts/auto_sync_agents.py --force
to rebuildAGENTS.md
andrules.index.json
. - Execute
python3 scripts/startup_checklist.py
to verify.
Do not commit real API keys (e.g. Brave Search) � keep placeholders.