codex-keysmith

From public sources

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

CLI toolCategory: Developer Tools · AI codingOpen sourcedata checked Oct 15, 2026

Add to compare Add to collection

Overview

cli
codex
codex-cli
configuration-management
developer-tools
local-first
prompt-engineering
python

Installation

Commands are shown, never run by the marketplace. Check them against the official documentation.

Official websiteFrom public sourcesfrom catalog metadata
github.com/Jia-Ethan/codex-keysmith/releases/latest ↗
Official release filesFrom public sourcesfrom the latest official release
github.com/Jia-Ethan/codex-keysmith/releases/tag/v0.6.0 ↗
Build from sourceFrom public sourcesfrom catalog metadata
Build from source: no validated build recipe — follow the repository instructions.
github.com/Jia-Ethan/codex-keysmith ↗

Compatibility

Unknown means no evidence was found — not that the product is incompatible.

Platform	Status	Architecture	Evidence	Confidence
Windows	Unknown	—	—	—
macOS	Unknown	—	—	—
Linux	Unknown	—	—	—
Container (OCI)	Unknown	—	—	—

Releases

checked Oct 29, 2026

v0.6.0LatestSep 10, 2026Official source ↗

Files in 0.6.0

The marketplace does not host these files: downloads go to the official source. Files have not been scanned by us.

File	Platform	Size	SHA-256	Download from the official source
codex-keysmith-v0.6.0.tar.gz	Unknown	6.2 MB	5aece0aaf0a7…	Official source ↗
codex-keysmith-v0.6.0.zip	Unknown	7.7 MB	049c8bc4044d…	Official source ↗
SHA256SUMS	checksums	383 B	ba85dbd594a7…	Official source ↗
codex-instruct-v0.6.0.py	other	705 KB	837ec2571385…	Official source ↗
codex-keysmith-scenarios-v0.6.0.bundle	other	64 KB	0c924e400e23…	Official source ↗

Release history

v0.5.1Sep 5, 2026Official source ↗
v0.5.0Aug 29, 2026Official source ↗
v0.3.8Aug 19, 2026Official source ↗
v0.3.7Aug 18, 2026Official source ↗
v0.3.6Aug 17, 2026Official source ↗
v0.3.5Aug 15, 2026Official source ↗
v0.3.4Aug 15, 2026Official source ↗

Quality profile

algorithm quality-v1.0 · assessed Oct 15, 2026

Quality Score87

Risk Score0

Confidence 1.00

Quality Score and Risk Score are different measures. A high score does not guarantee safety.

Score components

Maintenance · 2020

last activity 18 days ago

Documentation · 1515

README 5227 chars, description present

Ready to use · 156

install instructions: no; releases: yes

Metadata · 1010

4/4 of description, homepage, license, topics

Releases · 1010

7 release(s), latest 35 days ago

Category confidence · 107

classifier confidence 0.65

Adoption · 109

4743 stars (log-dampened, 10k = max)

License clarity · 55

SPDX MIT

Community · 55

issues enabled, 733 forks

License

MIT

Known licensefrom the repository host

This is the catalog policy status, not legal advice.

Sources

github.com/Jia-Ethan/codex-keysmithPrimary★ 4,743 starslast activity Sep 27, 2026Primary repository · Confidence 1.00

Reviews

No reviews yet.

Report a problem with this card

Alternatives

codeburnSimilar

Free, local tool to track AI coding token usage and cost across 37 tools and agents (Claude Code, Cursor, Codex, Gemini and more), by model, project, and task. npx codeburnMIT · Developer Tools

ouroborosSimilar

Agent OS: the agent gets smarter on its own. We just hold the line: Interview-gated, staged evaluation, budgeted evolution loop. MCP server, 14 runtimes: Claude Code, Codex CLI, Gemini CLI, OpenCode, Copilot, Kiro and more.MIT · Developer Tools

opencodexSimilar

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude CodeMIT · Developer Tools

lazycodexSimilar

The one and only agent harness for complex codebases. Project memory, planning, execution, and verified completion inside Codex.MIT · Developer Tools

CodewhaleSimilar

Open-source Rust agent engine and terminal client for Codewhale, with provider choice, tools, approvals and receipts.MIT · Developer Tools

README

From Jia-Ethan/codex-keysmith · license MIT · fetched Oct 29, 2026

简体中文

Keysmith 给本机的 AI 编程工具装指令：先预览，再写入，能验证，能撤走。

codex-keysmith 面向 Codex。装上之后，新开的对话会按这份指令工作。不改 Codex 软件本身，也不读取账号和密钥。默认只装一份稿。

[!IMPORTANT] 这会改变该 Codex 配置下 之后新开的对话。默认只给你看计划，加上确认才会写入。装完后请开一个新任务。

使用方式

先看计划。 确认之前什么都不会写入。
确认后装上。 指令交给本机 Codex，软件保持原样。
新开一轮对话。 关掉旧任务，开一个新的。
随时撤走。 同样先看计划，确认后恢复成原来的样子。

选哪个 Keysmith

你在用	用这个	怎么开始
Codex	codex-keysmith	稳定版安装包
Claude Code	claude-keysmith	源码
Grok Build	grok-keysmith	稳定版安装包
ZCode	zcode-keysmith	源码

每个工具一份安装器。也有未签名桌面版（Apple Silicon / Windows x64）。

开始使用

本机需要已经装好 Codex。稳妥路径是最新稳定 Release 的单文件脚本（当前公开稳定脚本包括 codex-instruct-v0.6.0.py）。也有未签名桌面版。

# 把 vX.Y.Z 换成 Releases 页的最新稳定 tag
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
# 确认目标目录、提示词来源和写入计划后：
python3 codex-instruct-vX.Y.Z.py --codex-dir ~/.codex --yes --lang zh-CN

源码路径：git clone https://github.com/Jia-Ethan/codex-keysmith.git && cd codex-keysmith，再把上述脚本名换成 codex-instruct.py。装完后关掉旧任务，开一个新 Codex 会话。Windows 把 python3 换成 python。也可以把代装说明交给你正在用的 AI 助手。细节见使用说明。

怎么撤走

以下以 Release 单文件为例；源码 checkout 请把文件名换成 codex-instruct.py。

python3 codex-instruct-vX.Y.Z.py --codex-dir ~/.codex --restore-hooks --lang zh-CN
python3 codex-instruct-vX.Y.Z.py --codex-dir ~/.codex --uninstall --lang zh-CN
python3 codex-instruct-vX.Y.Z.py --codex-dir ~/.codex --uninstall --yes --lang zh-CN

--reactivate 从 v0.3.9 开始提供：

python3 codex-instruct-vX.Y.Z.py --codex-dir ~/.codex --reactivate
python3 codex-instruct-vX.Y.Z.py --codex-dir ~/.codex --reactivate --yes --lang zh-CN

先看计划，确认后再恢复。

适用环境

macOS 与 Linux 为主要支持。Windows 新鲜部署仍是测试通道。需要 Python 3.10+。本安装器不主动收集或上传用户数据。未签名桌面版会碰到 Gatekeeper / SmartScreen，不是 SignPath Foundation 签名；实体机验收见发布说明（physical-device acceptance）。

文档

系列

codex-keysmith — 给 Codex
claude-keysmith — 给 Claude Code
grok-keysmith — 给 Grok Build
zcode-keysmith — 给 ZCode

官方反馈：GitHub Discussions · 社区：LINUX DO

Open the repository ↗