【开源自荐 / macOS】Workbench:把 Codex 那些不太好懂的功能放到一个窗口里

我平时 Codex 用得比较多,但有几个地方一直觉得不太顺手。

比如装了一个 Skill,它到底会自己调用,还是每次都要明确点名?Hook 配上以后什么时候会运行,刚才那次操作有没有触发?Memory 又记住了什么,对哪个项目有效?

还有一个比较现实的问题:~/.codex 会越用越大。缓存、日志、历史会话都堆在里面,想清理一下,又不太敢直接删。

这些东西分别都能查,只是要翻配置、看文件、找文档。索性自己 vibe coding 了一个 macOS 小工具,把它们放到了同一个窗口里。

项目叫 Workbench,主要给已经在使用 Codex,但不想天天翻配置文件的人用。

我主要想解决的几个问题

  • Skill 装了不少,但不知道哪些会自动调用,哪些必须主动点名

  • Hook 配好了,却不知道什么时候触发、具体做了什么

  • Codex 记了很多 Memory,桌面端里基本看不到

  • 本地文件越来越大,不清楚空间被什么占了,也不敢乱清

  • MCP 显示已配置,但不确定是否真的连上、读到了哪些工具

Skills

每个 Skill 都会显示用途、来源和依赖,同时区分隐式、显式、隐藏三种调用状态。

这些状态可以直接调整。改完之后,Workbench 会重新读取一次,确认是否真的生效。

Codex 里不少 Skill 和 Memory 的说明都是英文,来回复制翻译挺麻烦。我调用了 macOS 自带的翻译功能,可以直接在 Workbench 里看中文,也能随时切回英文原文,不需要另外配置翻译 API 或 Key。Memory 里的英文内容也会用同样的方式处理。

Hooks

我身边不少用 Codex 的朋友,其实并不知道 Hook 是做什么的。

所以这里没有只把 hooks.json 原样摆出来,而是尽量说人话:它什么时候触发、匹配什么操作、会执行什么、会不会拦下当前流程。

如果 Workbench 在运行,也能看到当前连接里观察到的触发记录,至少方便判断它刚才到底有没有跑。

Memory

Memory 这块是我自己最想看的。

Workbench 会把 Codex 的记忆分成当前生效和长期记忆,并标出来源、更新时间、相关项目和适用范围。

这里目前保持只读。需要修改时,可以把内容或整理要求复制给 Codex 处理,不直接在界面里改原始文件。

用量和本地占用

可以查看 Codex 返回的使用限额、Token 活动,以及本机 Codex 目录的空间占用。

缓存、日志、临时文件和归档会话会分开显示。能安全重建的缓存可以清理,其他内容会单独说明,不会做一个“全部清空”按钮。

另外还做了 MCP 状态、配置备份、菜单栏和系统自检。帖子先不逐个展开,不然有点太长了。

关于本地数据

Workbench 不需要注册账号,也没有遥测。看到的内容都来自本机 Codex、当前配置和实际运行结果。

Memory 默认只读,不读取或保存 Codex 登录令牌。项目完全开源,和 OpenAI 官方没有关系。

适合谁

  • 平时在 macOS 上使用 Codex

  • 装过一些 Skills,但不确定它们什么时候会被调用

  • 配置过 Hooks 或 MCP,想看看它们是否真的在工作

  • 想知道 Codex 记住了什么、本地文件占了多少空间

  • 不想为了这些事情反复翻配置和日志

项目是我这几天一边用一边改出来的,肯定还有不少没考虑到的地方。

如果你愿意帮忙试试,不用专门写测试报告。哪里看不懂、哪个按钮不敢点、显示结果和实际情况对不上,直接在评论区说一句或者贴张图就行。

项目地址:

下载地址:

https://github.com/fslot2601-source/workbench/releases/latest

需要 macOS 14 或更高版本,并且本机已经安装、登录 Codex。

目前发布的是未签名社区版本。第一次启动时,需要在 Finder 里找到 Workbench,右键选择“打开”。

有问题可以直接在评论区问,看到我会回。