---

name: codex-config-optimizer description: | Codex CLI config optimization skill. Use when:

• Editing agents.md or agents/
• User asks about Codex CLI config best practices
• User says "codex cli changelog" or "codex cli updates"
• User asks about new features or changes in Codex CLI

---

Codex CLI Optimizer Skill

Rules and tracking for Codex CLI configuration optimization.

1. Config File Location

User's Codex CLI config is stored at:

Copy~/ghq/github.com/i9wa4/dotfiles/config/codex/

Key files:

2. Config Generation

Why this structure?

config.toml contains full paths for trusted projects:

Copy[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-specific config.toml
• config.toml - Generated, machine-specific (Git-ignored)

How it works

generate-config.sh generates config.toml by:

1. Copy config.common.toml as base
2. Find all git repos under ~/ghq/github.com/
3. Add each repo as trust_level = "trusted"

Run when adding new repositories:

Copycd ~/ghq/github.com/i9wa4/dotfiles/config/codex && ./generate-config.sh

3. Fetch Releases

Use gh command to fetch the latest releases:

CopyFILE=$(${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

1. Fetch releases using the command above
2. Extract the first release entry
3. Categorize changes into:
   • New features (Added)
   • Bug fixes (Fixed)
   • Improvements (Improved/Changed)
   • Breaking changes
4. Present in Japanese with brief explanations

4.2. Version Diff

1. Ask user for start and end versions
2. Extract all releases between those versions
3. Summarize cumulative changes
4. Highlight breaking changes and deprecations

4.3. Breaking Changes Detection

1. Search for keywords: breaking, removed, deprecated, changed (behavior changes)
2. List affected commands and options
3. Provide migration guidance

5. Settings Categories

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)

Copy# 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