Open ContextBar
ContextBar appears in the Mac menu bar and does not show a Dock icon. Look for a reading such as C3 · 80%.
Support
Start clear. Stay current.
ContextBar is designed to stay quiet in the menu bar. This guide covers first launch for both official editions, common menu states, and the quickest way to recover.
使用支持
连接一次，安静运行。
ContextBar 打开后会安静地留在菜单栏。本指南同时说明官网版和 App Store 版的首次使用、常见状态和恢复方式。
Connect Codex
The website edition connects to the standard Codex folders automatically. The Mac App Store edition asks you to select the two required folders once.
Check the first reading
Open a Codex desktop task. When its name and context values appear, setup is complete. Both editions process data locally and never modify Codex files.
Follow the task in view
Bring any Codex desktop task to the front. ContextBar automatically follows the most recently focused Codex main window.
Common questions
Read the menu at a glance
What do “C3” and “80%” mean?
C3 means the active task has been compacted three times. 80% means the latest valid input context uses 80% of the model context window.
Why does ContextBar say “Waiting for data”?
A new task may not have produced a valid context reading yet. ContextBar also clears the old percentage after a compaction and waits for the next valid reading, rather than showing stale data.
Why is there no icon in the Dock?
The Dock is the app launcher usually shown along an edge of the Mac screen. ContextBar lives in the menu bar by design, so it does not take up a Dock position.
The menu is showing the wrong task. What should I do?
Bring the intended Codex desktop task to the front, then choose Detect Now in ContextBar. Background task updates should not replace the task currently in view.
Why does one edition need folder access while the other does not?
The Mac App Store edition runs inside Apple's App Sandbox, so it asks you to select two Codex folders on first launch. You can later choose Change Codex Data Access… from its menu. The website edition reads the standard Codex folders automatically and therefore has no authorization menu. Both editions process only the required local data, never modify Codex files, and never upload your data.
Does ContextBar support Codex CLI or other agents?
Version 1.0 supports the Codex desktop app on macOS. Pure Codex CLI sessions, Claude Code, and other terminal agents are not supported yet. Support for more agent data sources is planned for future updates—stay tuned.
打开 ContextBar
ContextBar 只显示在 Mac 菜单栏，不会在程序坞（Dock，通常位于屏幕边缘的应用图标栏）中占用位置。请在菜单栏寻找类似 C3 · 80% 的读数。
连接 Codex
官网版会自动连接 Codex 默认目录；App Store 版首次启动时需要按提示选择两个目录。
确认首次读数
打开一个 Codex 桌面任务。菜单显示任务名称和上下文数值后，即表示连接完成。两种版本都只在本机处理数据，不会修改 Codex 文件。
跟随眼前的任务
把任意 Codex 桌面任务切到前台。ContextBar 会自动跟随最近获得焦点的 Codex 主窗口。
常见问题
一眼读懂菜单状态
“C3”和“80%”分别是什么意思？
C3 表示当前任务累计压缩了三次；80% 表示最近一次有效输入上下文占模型上下文窗口的 80%。
为什么显示“上下文占用：等待统计”？
新任务可能还没有产生有效的上下文统计。发生压缩后，ContextBar 也会清除旧百分比，等待下一条有效统计，而不是继续展示过期数据。
为什么程序坞（Dock）里没有图标？
程序坞（Dock）是 Mac 屏幕边缘常见的应用图标栏。ContextBar 按设计只驻留在菜单栏，因此不会占用程序坞位置。
菜单显示的不是我正在看的任务，怎么办？
先把目标 Codex 桌面任务切到前台，再在 ContextBar 菜单中选择重新检测。后台任务的数据更新不应抢占当前任务。
为什么有的版本需要目录授权，有的不用？
App Store 版受 Apple App Sandbox 限制，首次启动时需要选择两个 Codex 目录，之后可以从菜单中选择重新授权 Codex 数据…。官网版会自动读取 Codex 默认目录，因此没有授权入口。两种版本都只处理功能所需的本地数据，不修改 Codex 文件，也不上传数据。
支持 Codex CLI 或其他 Agent 吗？
1.0 版本支持 macOS 上的 Codex 桌面 App，暂不支持纯 Codex CLI、Claude Code 和其他终端 Agent。后续将逐步增加对更多 Agent 数据源的支持，敬请期待。