wtf is codex-keysmith?

Codex keysmith is a small, dependency free Python script that deploys a custom instructions file into your Codex CLI configuration folder, so that every new Codex session loads it automatically. By default it shows you a preview of exactly what it plans to change and only writes anything after you explicitly confirm, and every deployment can be undone later. Because this changes a setting that Codex reads globally, the tool is upfront that it affects every new session under that configuration, not just one project. It also backs up your existing hooks file before touching it, and keeps that backup in place until you choose to restore it. The repository ships with one example instructions file as a sample of what a instructions file can contain, anyone using it should read the example first and decide whether it fits their own use before applying it, or supply their own file instead using a command line flag. A newer feature lets you deploy instructions scoped to just one project folder instead of your whole Codex configuration, tracked separately so each project's deployment can be listed, checked, or removed on its own. The project also documents how to use it alongside a separate configuration switching tool so that different saved profiles can each keep their own version of the deployed instructions turned on or off. The tool includes commands to check the current status of a deployment, recover from an interrupted run if the process was killed partway through, and fully uninstall a deployment while restoring the files it touched. It targets macOS and Linux as its main supported platforms, needs Python 3.10 through 3.14, and also has an early, unsigned desktop app in beta for macOS and Windows that wraps the same command line logic in a graphical interface. The project is released under the MIT license.