Open Source Radar
Jia-Ethan/

codex-keysmith

GitHub

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 --yes executes writes.
  • Operations affect top-level model_instructions_file across 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 --version
    • python3 codex-instruct-v0.1.0.py --codex-dir ~/.codex --dry-run --lang zh-CN
    • python3 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-CN
    • python3 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 --yes for writes, and requires reading built prompts before using --yes.
SharePost on XLinkedIn
All trending reposRevenue-verified startups →