Skip to content

chore(codex): stop tracking config.toml, keep a config.example.toml - #61

Merged
ryanspletzer merged 1 commit into
mainfrom
chore/untrack-codex-config
Oct 17, 2026
Merged

ryanspletzer merged 1 commit into
mainfrom
chore/untrack-codex-config

Conversation

@ryanspletzer

Copy link
Copy Markdown
Owner

Summary

  • Stop tracking .codex/config.toml: Codex rewrites it with machine state (absolute-path trust entries, hook hashes, nux counters) and the clean-filter approach was not worth the upkeep.
  • Add .codex/config.example.toml holding only the portable settings (model, [tui] status_line) for rebuilding a machine.
  • Remove the codex-config clean filter entirely: .gitattributes wiring, [filter "codex-config"] in .gitconfig, .agents/bin/codex-config-clean.py, and its tests.
  • Update AGENTS.md and the dotfiles-reference runbook; gitignore canaries now assert config.toml is ignored and config.example.toml is tracked.

Companion change in dev-machine-setup drops the git config --global filter.codex-config.clean re-assert.

Test plan

  • make test passes locally (canaries updated)
  • CI green

🤖 Generated with Claude Code

Codex rewrites ~/.codex/config.toml with machine state (absolute-path
trust entries, hook hashes, nux counters), and keeping the tracked blob
portable via the codex-config clean filter was not worth the upkeep.

- untrack .codex/config.toml; add .codex/config.example.toml with the
  portable settings (model, [tui] status_line) for rebuilding a machine
- remove the clean filter: .gitattributes wiring, [filter "codex-config"]
  in .gitconfig, .agents/bin/codex-config-clean.py and its tests
- update AGENTS.md and the dotfiles-reference runbook
- gitignore canaries: config.toml must be ignored, config.example.toml
  tracked

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@ryanspletzer
ryanspletzer merged commit 75307d0 into main Oct 17, 2026
1 check passed
@ryanspletzer
ryanspletzer deleted the chore/untrack-codex-config branch October 17, 2026 00:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant