Jia-Ethan开发者工具

Codex Keysmith

codex-keysmith

Codex CLI 指令部署工具,支持自定义提示词预览、备份、钩子隔离及一键撤销。

  • DevOps / 运维
  • 后端
  • 自动化
  • 效率 / 生产力
  • CLI
  • 桌面
  • macOS
  • Linux
  • Windows
  • 支持本地运行
  • 需要 API Key
codex-keysmith 截图
社区热度
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 隔离功能以管理全局行为

快速开始

安装方式、上手难度、开始步骤。

装在哪

本地运行

难不难

中等,需要一点配置

支持本地运行
  1. 01下载并校验脚本文件的 SHA256 摘要。
  2. 02运行预览命令查看将要进行的配置变更。
  3. 03确认无误后,执行部署命令写入配置。
  4. 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

根据分类、能力和适用角色匹配的其他已核验项目。