codex-config

Version-controlled configuration for OpenAI Codex CLI and Claude Code. Keeps settings, development instructions, and notification scripts in Git so they can be reviewed, diffed, and synced to ~/.codex and ~/.claude on any machine.

Repository Layout

config.toml        # Codex CLI settings (model, sandbox, features, TUI, etc.)
AGENTS.md          # Global development standards & coding guidelines
notify.ps1         # Windows toast notification script (BurntToast)
scripts/
  sync.py          # Copies allowlisted files into ~/.codex and ~/.claude
tests/
  test_sync.py

Setup

uv sync --group dev

Sync

uv run python scripts/sync.py

Copies allowlisted files to their configured destinations:

Source	Destination
config.toml	~/.codex/config.toml
AGENTS.md	~/.codex/AGENTS.md
notify.ps1	~/.codex/notify.ps1
AGENTS.md	~/.claude/CLAUDE.md

• Overwrites destination files that share the same relative path.
• Leaves destination files outside the allowlist untouched.
• Does not commit or push.

Skills

# Install skills
npx skills add https://github.com/vercel-labs/agent-browser --skill agent-browser -g -a codex -a claude-code -y
npx skills add https://github.com/trailofbits/skills --skill ask-questions-if-underspecified -g -a codex -a claude-code -y
npx skills add https://github.com/noahacgn/codex-config --skill exec-plans -g -a codex -a claude-code -y

# List global skills
npx skills ls -g

# Update all skills
npx skills update

# Remove all global skills
npx skills remove --all -g

Quality Checks

uv run pytest
uv run ruff check .
uv run ty check scripts tests

Requirements

• uv
• Python 3.11+
• Git
• Node.js and npm (for skills management)

Acknowledgements

• trailofbits/claude-code-config