codex-keysmith

Versioned Codex instruction deployment with preview, ownership manifests, hook isolation, scenario evaluation, and recovery.

What is codex-keysmith?

Versioned Codex instruction deployment with preview, ownership manifests, hook isolation, scenario evaluation, and recovery.

Overview of codex-keysmith

What it is

codex-keysmith is a tool for versioned Codex instruction deployment. It allows users to preview, install, verify, and remove instructions for the Codex AI coding tool on the local machine. It does not modify the Codex software itself, nor does it read accounts or keys. By default, it only installs one draft at a time. The tool is part of a series that includes versions for Claude Code, Grok Build, and ZCode.

Key features

  • Preview instructions before writing them to Codex.
  • Install instructions with user confirmation.
  • Verify the installation status.
  • Remove (uninstall) instructions and restore hooks.
  • Reactivate instructions from version 0.3.9 onward.
  • Supports dry-run mode to show the plan without making changes.

Use cases

  • Deploying custom instructions for Codex to guide new conversations.
  • Testing instruction changes safely with preview and dry-run.
  • Reverting to a previous state by uninstalling or reactivating instructions.
  • Managing instruction deployment across multiple Codex configurations.

Getting started

Ensure Codex is installed locally. Download the latest stable release script from the repository's Releases page. Replace vX.Y.Z with the actual latest stable tag. bash base='https://github.com/Jia-Ethan/codex-keysmith/releases/download/vX.Y.Z' curl --fail --location --remote-name '$base/codex-instruct-vX.Y.Z.py' curl --fail --location --remote-name '$base/SHA256SUMS' awk '$2 == 'codex-instruct-vX.Y.Z.py'' SHA256SUMS | shasum -a 256 -c - python3 codex-instruct-vX.Y.Z.py --version python3 codex-instruct-vX.Y.Z.py --codex-dir ~/.codex --status --lang zh-CN python3 codex-instruct-vX.Y.Z.py --codex-dir ~/.codex --dry-run --lang zh-CN # After reviewing the plan: python3 codex-instruct-vX.Y.Z.py --codex-dir ~/.codex --yes --lang zh-CN For source code, clone the repository and use codex-instruct.py instead. On Windows, replace python3 with python. After installation, close the old task and start a new Codex session.

License and pricing

The license is MIT. The pricing type is open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/jia-ethancodex-keysmith.svg)](https://yunodb.com/tools/jia-ethancodex-keysmith?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/jia-ethancodex-keysmith?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/jia-ethancodex-keysmith.svg" alt="Featured on YunoDB" height="20"></a>