Codex,
就在刘海里。

Mac 上的 Codex 通知、权限批准,以及 5 小时和每周额度

Gnista 把每个 Codex 会话都显示在 MacBook 的刘海里。Codex 想跑命令或打补丁,就在那里允许或拒绝;一轮结束,就在那里回复。你的 5 小时和每周额度就在会话下方。

免费试用 7 天 无需账号和银行卡 · 之后一次性 €19
01概览

Codex 配 Gnista,一目了然。

运行环境
任意终端或编辑器终端里的 Codex CLI,包括 VS Code 的终端;Codex 应用里的线程;IntelliJ IDEA 等 JetBrains IDE 的 AI 聊天里的 Codex;Xcode 里的 Codex(怎么设置);还有通过 SSH 跑在 Linux 服务器上的 Codex CLI。
设置
hooks 写在 ~/.codex/hooks.json,连接时在 ~/.codex/config.toml 里记为已信任:不用在 Codex 里信任什么。
需要你
权限请求,附带完整的命令或补丁,还有 Codex 在一轮结束时提的问题。
在刘海里回应
允许,或拒绝,可附上理由,Codex 会读;“始终”做不到,因为 Codex 不从 hook 接受它。一轮结束时的提问也行:你选的会作为你的下一条消息送进去。
在刘海里回复
可以,走 Codex 自己的 codex queue:Codex 空闲就立刻执行,正忙就等这一轮结束。
这一行显示
会话标题、你的提示词、最新消息、命令或补丁、计划进度(“3/7 · Writing tests”)、模式、上下文和费用。
子 Agent
显示:这一行会写明哪个子 Agent 在干活、它当前的步骤,以及完成了几个。
费用与限额
每一轮按所用模型的价格计价,还有你的 5 小时和每周额度,读自 Codex 自己的会话记录。

允许,拒绝,接着干。

刘海展开,显示 Codex 想跑的那条命令或补丁,一字不差。允许,或附上理由拒绝:Codex 会显示“Denied from Gnista”,然后带着你的回应继续。

回复,直达会话。

Gnista 用的是 Codex 自己的 codex queue,所以从刘海发出的回复会以你的消息出现在打开的窗口里,任何终端或编辑器都行:Codex 空闲就立刻执行,正忙就等这一轮结束。终端里的 Codex 已经退出了?回复会在后台把会话接着跑起来;在后台 Codex 没法问你任何事,所以只做它的沙盒允许的事。

进度,一眼看懂。

Codex 的计划会以进度的形式显示在这一行,外加它正在哪一步,子 Agent 也一样。模式也在:Plan、Auto、Don’t ask、Bypass。

额度,不用你问。

Codex 每一轮都会记下你的速率限制。Gnista 读取这些记录,把你的 5 小时和每周窗口显示在会话下方,并按模型的价格给每一轮计价。Gnista 不认识的模型,可以写进模型文件。

Codex 上做不到的事,以及原因。

  • Codex 不从 hook(钩子)接受“始终”,所以刘海里只有允许和拒绝。要永久允许某件事,请在 Codex 里操作。
  • Codex 在会话开始时读取 hooks,所以在你连接 Gnista 之前开的会话会跳过它们,直到你开一个新会话。
  • 你不回应的话,Codex 会在它自己的提示里问你:你就在该会话的标签页时立刻问,刘海收起时 10 秒后问,你在刘海里时最多 45 秒后问。
  • 执行 /new 或 /resume 后,旧会话那一行要过大约一分钟,等 Codex 放手后才会消失。
02设置

接入只需一分钟。

  1. 打开 Gnista,勾选 Codex。Gnista 先把 ~/.codex/hooks.json 和 ~/.codex/config.toml 备份到 ~/Library/Application Support/Gnista/Backups/,再把它的 hooks 加在你的旁边,并记为已信任,和你自己在 Codex 里信任它们时一样。
  2. 开一个新的 Codex 会话。它会直接运行 Gnista 的 hooks,不再问你。
  3. 要在刘海里回应请求,打开设置 ▸ 通用 ▸ 在 Gnista 中回应提示。
03常见问题

Codex,有问必答。

能在刘海里批准 Codex 吗?

能:打开设置 ▸ 通用 ▸ 在 Gnista 中回应提示后,可以允许,或附上理由拒绝。没有“始终”:Codex 不从 hook 接受它。你不回应的话,Codex 会在它自己的提示里问你。

为什么 Codex 没在 Gnista 里出现?

Codex 在会话开始时读取 hooks,所以在你连接 Gnista 之前开的会话会跳过它们:开一个新会话就好。不用在 Codex 里信任什么:连接时已经在 ~/.codex/config.toml 里把 Gnista 的 hooks 记为已信任。

Codex 应用也行吗?

行。Codex 应用跑 Codex 用的是同一套 hooks,所以它的线程和其他会话一样各占一行,应用显示为 Codex,点一下就打开那个线程。

能在刘海里回复 Codex 吗?

能,任何终端或编辑器都行。Gnista 把你的回复交给 codex queue,所以它会在会话里显示为你的消息。

Gnista 能显示我的 Codex 用量额度吗?

能:5 小时和每周窗口,或者免费套餐唯一的那个窗口,都读自 Codex 自己的会话记录。不用开启什么,也不用登录。

它会改我的 Codex 配置吗?怎么移除?

它把 hooks 加进 ~/.codex/hooks.json,并在 ~/.codex/config.toml 里记为已信任,改前先把两者备份到 ~/Library/Application Support/Gnista/Backups/,你的 hooks 不动。设置 ▸ 智能体 ▸ Codex ▸ 断开连接删掉的正好是 Gnista 的 hooks 和它们的信任记录。

它能用于服务器上、通过 SSH 跑的 Codex 吗?

能,Linux 服务器就行。在设置 ▸ 远程里用你 ssh 配置里的一个主机连接那台服务器:Gnista 把它的辅助程序放过去,把它的 hooks 加进服务器上 Codex 的 hooks.json,和在你的 Mac 上一样记为已信任。那边的会话会带着机器名显示,还有标题、最新消息和费用;在刘海里的回应会送到那边的 Codex,点一下就回到你 ssh 登录的那个终端标签页,连 tmux 窗格也对得上,或者编辑器的 Remote-SSH 窗口。分步说明:通过 SSH 使用 Agent。

Gnista 还照看着

自己写了个 Agent?一行 JSON 就能向 Gnista 汇报:自定义 Agent。