- 社区热度
- 3.6k Stars
- GitHub 收藏
- 最近活跃
- 2026/8/17
- 近 30 天还在更新
- 授权协议
- MIT
- 宽松协议
为什么值得关注
不是看 Star 排名,而是看它解决了什么问题、实际有没有用,以及方法为什么值得关注。
解决的问题
解决了用户在多会话场景下难以对 Codex 全局行为、指令与 hooks 进行统一版本化管理、预览及安全回滚的问题。
实际价值
提供包含预览、所有权清单、hook 隔离与分层卸载的零依赖 Python 脚本及 Tauri 桌面端,能有效执行部署并恢复。
创新 / 差异化
通过显式预览与 `--dry-run` 机制、所有权清单(manifest)和正交的 target-local 场景部署,将配置文件变更转变为可追踪、可审计的事务。
扩展潜力
可与配置切换工具(如 CCSwitch)配合,通过独立 Provider 副本隔离 On/Off 状态,并支持通过脚本或 bundle 进行离线场景验证与评测。
为什么是现在
当前大模型本地与全局行为配置频繁变更,对指令部署的可控性、隔离性与审计需求正逐渐上升。
核心亮点
- 通过 CLI 部署 Codex 指令文件并自动修改配置文件
- 支持部署前预览、操作备份及一键回滚机制
- 提供 hooks.json 隔离功能以管理全局行为
快速开始
安装方式、上手难度、开始步骤。
装在哪
本地运行
难不难
中等,需要一点配置
- 01下载并校验脚本文件的 SHA256 摘要。
- 02运行预览命令查看将要进行的配置变更。
- 03确认无误后,执行部署命令写入配置。
- 04重启 Codex 会话以加载新的指令配置。
更适合谁
- 想在本机直接跑起来试用的开发者
更多介绍
codex-keysmith 是一个单文件 Python 脚本,为 Codex CLI 提供版本化的指令部署方案。它通过修改 ~/.codex/config.toml 中的 model_instructions_file 字段,强制所有新会话加载指定的 Markdown 指令文件。工具内置了事务处理机制,在写入前提供 dry-run 预览,并支持随时撤销变更或恢复原始钩子状态。
信息来源
每条信息都标注了状态与出处,可展开查看。
15 条 · 展开
信息来源
每条信息都标注了状态与出处,可展开查看。
capability tags
已核验automation、productivity
来源: admin_cms · cms editor · 2026/8/21
editor note
已核验{"en":"This tool injects instructions by modifying global Codex configuration files and provides hook isolation. It is suitable for developers requiring granular control over Codex session behavior; always use dry-run to preview changes before deployment.","zh":"该工具通过修改 Codex 的全局配置文件实现指令注入,并提供钩子隔离功能。适合需要对 Codex 会话行为进行精细化控制的开发者使用,部署前务必通过 dry-run 预览变更。"}
来源: admin_cms · cms editor · 2026/8/21
how to use
已核验{"steps":[{"en":"Download the script and verify its SHA256 checksum.","zh":"下载并校验脚本文件的 SHA256 摘要。"},{"en":"Run the preview command to inspect the intended configuration changes.","zh":"运行预览命令查看将要进行的配置变更。"},{"en":"Execute the deployment command to apply the configuration once verified.","zh":"确认无误后,执行部署命令写入配置。"},{"en":"Restart your Codex session to load the new instruction configuration.","zh":"重启 Codex 会话以加载新的指令配置。"}],"installAt":"local","difficulty":"medium"}
来源: admin_cms · cms editor · 2026/8/21
intro
已核验{"en":"codex-keysmith is a single-file Python script designed to provide versioned instruction deployment for Codex CLI. It forces all new sessions to load specified Markdown instruction files by modifying the `model_instructions_file` field in `~/.codex/config.toml`. The tool includes a transactional mechanism that offers dry-run previews before execution and supports full rollbacks or hook restoration.","zh":"codex-keysmith 是一个单文件 Python 脚本,为 Codex CLI 提供版本化的指令部署方案。它通过修改 `~/.codex/config.toml` 中的 `model_instructions_file` 字段,强制所有新会话加载指定的 Markdown 指令文件。工具内置了事务处理机制,在写入前提供 dry-run 预览,并支持随时撤销变更或恢复原始钩子状态。"}
来源: admin_cms · cms editor · 2026/8/21
最新版本
已核验v0.3.5
来源: GitHub 官方接口 · latest_release=v0.3.5 · 2026/8/17
许可证
已核验MIT
来源: GitHub 官方接口 · license.spdx_id=MIT · 2026/8/17
needs api key
已核验是
来源: admin_cms · cms editor · 2026/8/21
一句话用途
已核验{"en":"A Codex CLI deployment tool for managing custom instructions with preview, backup, hook isolation, and rollback capabilities.","zh":"Codex CLI 指令部署工具,支持自定义提示词预览、备份、钩子隔离及一键撤销。"}
来源: admin_cms · cms editor · 2026/8/21
平台
已核验macos、linux、windows
来源: admin_cms · cms editor · 2026/8/21
分类线索
根据材料推断ai-apps
来源: 项目说明文档 · hint=ai-apps · 2026/8/15
product forms
已核验cli、desktop
来源: admin_cms · cms editor · 2026/8/21
role tags
已核验devops、backend
来源: admin_cms · cms editor · 2026/8/21
supports docker
已核验否
来源: admin_cms · cms editor · 2026/8/21
supports local
已核验是
来源: admin_cms · cms editor · 2026/8/21
supports self host
已核验否
来源: admin_cms · cms editor · 2026/8/21
相关项目
根据分类、能力和适用角色匹配的其他已核验项目。
spec-kit
一套遵循「规范驱动开发」流程的开源 CLI 工具包,配合 AI 编程 Agent 按照规范生成与执行代码。
CLI-Anything
为现有软件生成和管理 Agent 可调用 CLI 的工具集,包含 CLI-Hub、生成流程与 SKILL/插件接入方式。
opencodex
一个通用的本地代理,允许在 Codex、Claude Code 等工具中使用任意大模型(如 Claude、Gemini、DeepSeek 等)并管理 ChatGPT 账号池。
microsandbox
用于运行不受信任工作负载的快速本地微型虚拟机运行时与库。
xplr
可脚本化和扩展的终端 TUI 文件浏览器,用键盘界面组织文件操作并与现有命令行工具、插件和脚本集成。
agentdock
为 AI 助手提供安全、受控的访问权限,以操作您运行的每台机器。

