codex-config-optimizer skill

---
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:

```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-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:

```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

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

| 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

- [x] AGENTS.md symlinked to CLAUDE.md (shared persona)
- [x] skills/ symlinked to Claude Code skills
- [x] prompts/ symlinked to Claude Code commands
- [x] 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>