Open Source Radar
Codex-keysmith is a single-file Python CLI that deploys Codex model_instructions_file with preview, backups, and hook isolation, emphasizing dry-run by default and recoverable workflows.
768stars
126forks
0issues
MITlicense
2026since
Star historydaily snapshots by VibeCrowd
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
Alternatives & relatedmatched by topic overlap
Reviewgenerated from repository data · Jul 18, 2026
What it is
codex-keysmith is a zero-runtime-dependency, single-file Python CLI designed to deploy and manage Codex model_instructions_file configurations in a preview-first, recoverable manner. It supports backups, hook isolation, and layered uninstall, with a focus on a durable journal and manifest-based state tracking.
How it works
- Default behavior is dry-run; explicit
--yesexecutes writes. - Operations affect top-level
model_instructions_fileacross the Codex configuration and pause active hooks unless restored. - Uses manifests, journals, and snapshots to enable recoveries (
--recover) and uninstall workflows. - Provides status (
--status) that does not parse hooks content. - Custom prompts and language control via
--lang.
Getting started
- Release shown: v0.1.0 with zero-runtime-dependency, single-file Python CLI.
- Primary commands shown in README examples:
python3 codex-instruct-v0.1.0.py --versionpython3 codex-instruct-v0.1.0.py --codex-dir ~/.codex --dry-run --lang zh-CNpython3 codex-instruct-v0.1.0.py --codex-dir ~/.codex --yes --lang zh-CN
- Example for status:
python3 codex-instruct-v0.1.0.py --codex-dir ~/.codex --status --lang zh-CN
- Recovery and uninstall workflows shown via:
python3 codex-instruct-v0.1.0.py --codex-dir ~/.codex --recover --lang zh-CNpython3 codex-instruct-v0.1.0.py --codex-dir ~/.codex --uninstall --yes --lang zh-CN
Recent releases
- Latest: v0.1.0 codex-keysmith (2026-07-16)
- Release notes indicate a first formal version with the described behavior and dependencies; SHA256 and internal prompt references are embedded in the README.
Traction
- Stars: 716
- Forks: 115
- Open issues: 0
- Language: Python
- License: MIT
- Created: 2026-06-28
- Last push: 2026-07-18
Behind the repo
- Organization/user: Jia-Ethan
- Linked projects include claude-keysmith and zcode-keysmith as related series.
Caveats
- License: MIT
- Age: created 2026-06-28; last push 2026-07-18
- The README notes global behavior boundary: deployment changes the top-level model_instructions_file and pauses hooks.json until restored; does not patch binaries or store credentials.
- Windows experimental handling is described for v0.1.0.
- The project emphasizes dry-run as default, with explicit
--yesfor writes, and requires reading built prompts before using--yes.






