Codex CLI Optimizer Skill
Rules and tracking for Codex CLI configuration optimization.
1. Config File Location
User's Codex CLI config is stored at:
text
~/ghq/github.com/i9wa4/dotfiles/config/codex/
Key files:
| File | Git | Description |
|---|---|---|
.gitignore | Yes | Ignore all except whitelisted files |
config.common.toml | Yes | Common settings (model, MCP, etc.) |
generate-config.sh | Yes | Generate config.toml from common + repos |
prompts/ | Yes | Symlink to ../claude/commands/ |
AGENTS.md | No | Symlink to ../claude/CLAUDE.md |
skills/ | No | Symlink to ../claude/skills/ |
config.toml | No | Generated file (common + trusted repos) |
2. Config Generation
Why this structure?
config.toml contains full paths for trusted projects:
toml
[projects."/Users/uma/ghq/github.com/foo/bar"] trust_level = "trusted"
This path includes username, so config.toml cannot be shared across
machines with different usernames. Solution:
- •
config.common.toml- Shared settings (Git-managed) - •
generate-config.sh- Generate machine-specificconfig.toml - •
config.toml- Generated, machine-specific (Git-ignored)
How it works
generate-config.sh generates config.toml by:
- •Copy
config.common.tomlas base - •Find all git repos under
~/ghq/github.com/ - •Add each repo as
trust_level = "trusted"
Run when adding new repositories:
sh
cd ~/ghq/github.com/i9wa4/dotfiles/config/codex && ./generate-config.sh
3. Fetch Releases
Use gh command to fetch the latest releases:
sh
FILE=$(${CLAUDE_CONFIG_DIR}/scripts/touchfile.sh .i9wa4/tmp --type output)
gh api repos/openai/codex/releases --jq '.[0:5]' > "$FILE"
cat "$FILE"
4. CHANGELOG Operations
4.1. Latest Release Summary
- •Fetch releases using the command above
- •Extract the first release entry
- •Categorize changes into:
- •New features (Added)
- •Bug fixes (Fixed)
- •Improvements (Improved/Changed)
- •Breaking changes
- •Present in Japanese with brief explanations
4.2. Version Diff
- •Ask user for start and end versions
- •Extract all releases between those versions
- •Summarize cumulative changes
- •Highlight breaking changes and deprecations
4.3. Breaking Changes Detection
- •Search for keywords:
breaking,removed,deprecated,changed(behavior changes) - •List affected commands and options
- •Provide migration guidance
5. Settings Categories
| Category | Examples |
|---|---|
| Model | model, model_reasoning |
| Behavior | approval_mode, sandbox |
| Display | notify |
| Shell | shell_environment_commands |
| History | history, project_doc_max_bytes |
| Disable | disable_response_storage, hide_agent_* |
6. AGENTS.md Design Guidelines
- •YOU MUST: Focus only on persona and core guidelines
- •YOU MUST: Keep instructions compatible with both Claude Code and Codex CLI
- •NEVER: Include tool-specific syntax (e.g., Claude Code's TodoWrite)
7. Optimization Checklist
Check the following when editing AGENTS.md or config.toml:
- • Is the persona definition concise?
- • Are basic rules truly needed at all times?
- • Can detailed explanations be moved to skills/?
- • Is config.toml using appropriate approval_mode?
8. Optimization Tracking
Last reviewed Codex CLI version: v0.1.2504182016 (2025-04-18)
8.1. Applied Optimizations
- • AGENTS.md symlinked to CLAUDE.md (shared persona)
- • skills/ symlinked to Claude Code skills
- • prompts/ symlinked to Claude Code commands
- • config.common.toml for shared settings
8.2. Pending Considerations
- • Review new config options in future releases
- • Evaluate MCP server integration if available
9. Response Format (CHANGELOG)
text
# Codex CLI vX.X.X 更新内容 ## 新機能 - [機能名]: [説明] ## バグ修正 - [修正内容] ## 改善 - [改善内容] ## 破壊的変更 - [影響を受ける機能と移行方法] --- Source: https://github.com/openai/codex/releases
10. Important Notes
- •Codex CLI changelog is on the releases page, not CHANGELOG.md
- •Use GitHub releases API to fetch release notes
- •Always specify the version being referenced
- •Link to official release page when available
11. Reference Links
- •Codex CLI: https://github.com/openai/codex