Codex Keysmith is a zero-dependency Python utility for deploying versioned instruction files into Codex configuration directories. It updates the global model instruction setting so every new Codex session under that configuration loads the selected Markdown file. The tool previews changes by default and requires explicit confirmation before writing. It creates backups, isolates existing hooks, and records file ownership in a manifest for controlled recovery. Status checks and dry runs show the target directories, prompt source, and planned modifications before deployment. Layered uninstall removes only the newest deployment while preserving unrelated configuration changes. Users can restore hooks separately, deploy to multiple discovered directories, and supply their own instruction file.
Features
- Single-file Python deployment
- Default dry-run previews
- Explicit write confirmation
- Backup and manifest tracking
- Existing hook isolation
- Layered uninstall and recovery