by Jia-Ethan
Version-independent Codex instruction deployment with dry-run, backups, hook isolation, and recovery.
# Add to your Claude Code skills
git clone https://github.com/Jia-Ethan/codex-keysmithGuides for using cli tools skills like codex-keysmith.
Last scanned: 7/15/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-07-15T06:12:47.365Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}codex-keysmith is an open-source cli tools skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Jia-Ethan. Version-independent Codex instruction deployment with dry-run, backups, hook isolation, and recovery. It has 3,292 GitHub stars.
Yes. codex-keysmith passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/Jia-Ethan/codex-keysmith" and add it to your Claude Code skills directory (see the Installation section above).
codex-keysmith is primarily written in Python. It is open-source under Jia-Ethan on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other CLI Tools skills you can browse and compare side by side. Open the CLI Tools category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh codex-keysmith against similar tools.
No comments yet. Be the first to share your thoughts!
Top skills in this category by stars
codex-keysmith 是一个零依赖的单文件 Python 脚本，把一份指令 Markdown 部署到你的 Codex 配置目录（~/.codex），并让 Codex 的每个新会话都加载它。默认预览、显式确认才写入，支持随时撤销。
这会改变 Codex 的全局行为，不是项目级设置：部署会修改 ~/.codex/config.toml 里的 model_instructions_file，因此影响该配置下的所有新会话；默认还会暂停你现有的整份 hooks.json，直到你显式恢复。内置的示例提示词会让模型不再用拒绝式话术回答，把 reverse shell / keygen / bypass 一类请求当作本地样本处理，也覆盖成人题材、化学/药理/武器类内容。这不是安全边界，是一次影响很广的行为切换——用前请打开 examples/gpt-unrestricted.md 看一眼，或者用 --file 换成你自己的指令。
[!WARNING] 不要在 Windows 上使用已发布的
v0.1.0；它有已知的清理缺陷（详见「兼容性与限制」）。v0.1.1 及后续版本已提供原生恢复后端；Windows fresh deployment 仍标记为 beta。
仓库现已包含 gui/ 桌面客户端源码。它基于 Tauri 2 + React，复用现有 Python CLI 的预览、部署、恢复和卸载逻辑，不在 GUI 中重写文件事务。
cd gui
npm install
npm run tauri dev
0.2.0。desktop-v0.2.0-beta.6 统一提供 macOS Apple Silicon DMG、Windows x64 NSIS、单文件 CLI 和确定性源码归档。codex-keysmith-0.2.0-macos-arm64-unsigned.dmg；Windows 用户下载 codex-keysmith-0.2.0-windows-x64-unsigned-setup.exe。两个安装包都内置独立 CLI sidecar，使用时无需额外安装 Python。EXPLICIT_BETA。CODE_SIGNING_POLICY.md，本地数据说明见 PRIVACY.md。SignPath Foundation 申请仍在审核中，当前预发布资产并未使用 SignPath 签名。# 1. 下载并校验（把 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"
shasum -a 256 -c SHA256SUMS
# 2. 先看，不要先信——确认目标目录、内置提示词来源和将要写入的内容
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
# 3. 确认无误后才写入
python3 codex-instruct-vX.Y.Z.py --codex-dir ~/.codex --yes --lang zh-CN
不要从浮动 main 安装正式版本，也不要用 curl | python 直接执行——务必先落盘、校验，再运行。部署完成后关闭旧任务、开启一个新的 Codex 会话：Codex 只在会话启动时加载配置，运行中的会话不会热更新。
省略 --codex-dir 会处理全部自动发现的 .codex 目录；只有明确需要多目录一起部署时才这样做。
| 路径 | 会发生什么 |
|---|---|
<codex-dir>/gpt-unrestricted.md（或自定义 --name） |
新建，或先备份再替换 |
<codex-dir>/config.toml |
只拥有并修改顶层 model_instructions_file；外部工具重写其他字段不会阻塞 status/uninstall，卸载会保留这些字段 |
<codex-dir>/hooks.json |
默认整体隔离为 hooks.json.disabled（先备份） |
<codex-dir>/.codex-keysmith-manifest.json |
记录这次部署改了什么，供后续卸载用 |
完整字段、临时事务目录和边界条件见 docs/reference.md。
当 CCSwitch 以 Provider 为单位保存并整体写回 Codex config.toml 时，可以让两个 Provider 副本分别保存 Keysmith 的 On / Off 配置：
model_instructions_file，On / Off 两个副本也不要借助「应用通用配置」共享该字段，否则 Off 的有效 live config 仍会被合并成 On。--skip-hooks-isolation。model_instructions_file 的 Off 副本，再运行 --status 验证。On 应显示 配置激活状态: active，Off 应显示 inactive-by-config；若 Off 仍是 active，先从 Provider 配置和通用配置片段中移除该字段。Off 不是损坏，但部署和卸载仍保持 blocked；先切回 On 副本再执行写操作。这条流程按 CCSwitch v3.18.0（ff3bc242）的普通 Provider 切换与回填行为核对。代理接管热切换在该版本也可能从目标 Provider 的有效配置重建 live config，但还叠加 restore backup、通用配置合并和代理字段覆盖，Keysmith 不把它作为稳定兼容契约。配置切换只影响新会话，也不会随之切换 hooks.json / hooks.json.disabled。
# 只想拿回 hooks，不动指令/配置：
python3 codex-instruct.py --codex-dir ~/.codex --restore-hooks --lang zh-CN
# 想整体撤销这次部署（配置、指令、hooks 一起还原）：
python3 codex-instruct.py --codex-dir ~/.codex --uninstall --lang zh-CN # 先预览
python3 codex-instruct.py --codex-dir ~/.codex --uninstall --yes --lang zh-CN # 确认卸载
卸载每次只撤销最新一层部署；部署过多次的话，重复运行逐层撤销。config 的长期所有权只覆盖顶层 model_instructions_file：CCSwitch 等工具重写其他字段时，只要该字段仍引用本层 MD，status 和卸载仍可继续；卸载只恢复/移除部署前的该字段语句并保留其余当前内容。字段缺失时，只读 status 会识别为 inactive-by-config，但 deploy/uninstall 仍会 fail closed，直到切回引用本层 MD 的配置；字段改指其他路径、存在歧义或使用扫描器不支持的语句结构仍属于冲突。
| 现象 | 应该做的事 |
|---|---|
中途被强制中断（比如 SIGKILL、断电） |
先 --status 看是否报告 blocked；有的话用 --recover 预览，确认无误再加 --yes |
--status 报告异常残留 |
不要手工删除任何 .codex-keysmith-transaction-*、备份或 manifest；按上面 --recover 流程处理，或参考 docs/hooks-transactions.md |
| 想彻底清掉旧备份 | 见 docs/reference.md 里的清理前置条件，工具本身不自动删备份 |
codex-cli 0.144.1。macos-15 原生 CI 构建并公开为 Desktop Beta，尚未进行 Apple 签名、公证或实体设备验收。v0.1.0 存在已知缺陷（os.utime 失败后触发第二个 PermissionError，会留下无法用旧脚本恢复的 journal）。v0.1.1 及后续版本已重写 Windows 文件系统后端并标记 EXPLICIT_BETA，可以试用，但还不是正式支持；如果 v0.1.0 留下了 journal，用最新已校验 Release 脚本按 --status → --recover 预览 → --recover --yes → --status 的顺序恢复，不要手工删除任何证据。windows-2025 原生 CI 构建并公开为 Pre-release，但没有 Authenticode 签名或实体设备验收；它不扩大上述 CLI 的 EXPLICIT_BETA 支持边界，也不等于正式 Windows 支持。pip install 或自动更新；备份和卸载归档不会自动清理。docs/reference.md。提交前阅读 CONTRIBUTING.md。漏洞通过 SECURITY.md 指定的 GitHub 私密渠道报告；不要在公开 Issue 中粘贴凭证、完整配置或私人路径。
本项目接受 LINUX DO 社区佬友监督与反馈：LINUX DO
同系列项目 / Same series:
CLAUDE.md import-block installer for local instruction files.AGENTS.md installer with compat/hook isolation.AGENTS.md installer for local instructions.English version: README.en.md。智能体安装提示词见 docs/agent-install.md。