常见问题
一个免费开源的 AI 编码 Agent 状态伴侣，常驻 macOS 菜单栏——支持 Claude Code、Codex、Gemini、Grok、Cursor。它显示实时会话状态、在轮到你时叫你回来、把额度与成本摆在眼前，所有数字都在你自己的电脑上算出来
macOS 13 及以上（Apple 芯片与 Intel 通用包），以及 Windows 10/11 的原生 WPF 版本。macOS 已是 v2.1.1，Windows 端马上同步
执行 brew install tristan666666/tap/agentisland，或从 GitHub Releases 下载 DMG 拖进「应用程序」
从 GitHub Releases 下载 zip 解压运行 AgentIsland.exe，也可以用 winget 或 scoop 安装
是。MIT 开源，不用注册、没有付费档、没有试用倒计时
这个包是 ad-hoc 签名（没有付费的 Apple 开发者证书），首次打开需要右键点「打开」一次。之后的更新会各自验证 EdDSA 签名，独立可信
App 会检查 GitHub Releases，通过 Sparkle 原地更新并验证签名。用 Homebrew 装的也可以 brew upgrade
从设置侧栏退出，然后删除 App——或执行 brew uninstall --cask agentisland。不会残留任何后台服务
五家：Claude Code、Codex、Gemini、Grok、Cursor。实时会话状态（工作中 / 卡住 / 轮到你）覆盖 Claude Code、Codex、Grok、Gemini；Cursor 提供账期用量与订阅档位
Cursor 本地那个对话库是批量搜索缓存，不是实时流。把它当实时状态显示，等于把陈旧数据装成新鲜的——所以我们只显示用量，不假装
都支持。桌面端和终端里开的会话都会被追踪，各自带标题和项目名
需要 Gemini CLI 用 Google 账号登录过（oauth-personal 方式）。API key 与 Vertex 模式明确不支持，我们宁可说不支持，也不显示假数据
本机已有 grok CLI 登录。额度、重置倒计时、当月开销、实时会话状态都靠这份登录
从五家里任选两家常驻菜单栏小岛。无论选了谁，每一家在展开面板里都保留完整数据行
它读各家 Agent 本来就会写在本地的会话记录，寻找明确的回合结束标记——Claude 的 stop_reason、Codex 的 task_complete 事件、Grok 的 turn_completed 事件。不套壳、不劫持网络
这是设计。会话所属的 App 在最前台时提醒会先按住，等你切走且回合仍未处理时才弹。也可以开启前台提示音
提醒会排队，不会互相覆盖。你回应了哪个，哪个的提醒就消掉
永远不会。机器派生的子线程被完全过滤，只有真的在等你的人类回合才会提醒
刚才还在工作、但在回合中途停止产出的会话——通常值得你去看一眼
架构就是为此设计的——新的服务接进同一套扫描器和面板。需求在 GitHub issues 里跟进
来自各家自己的用量接口——和它们官方仪表盘调的是同一个——用的是你本机已有的凭据
不会。用量接口不消耗模型请求。轮询按你选的间隔跑：5、15 或 30 分钟
各家用滚动窗口计量订阅额度。Agent Island 会显示每个窗口的已用百分比和重置倒计时
额度百分比来自官方，是一致的。Token 总量和成本是本机算的、明确标为估算；Codex 还会把官方服务端口径的数字并排显示出来
小岛显示耗尽状态并可提醒你。Codex 还可以选择开启自动切换，轮转到你存好的下一个账号
可以。把每个登录存成命名档案，在服务菜单里一键切换。可选的「额度用完自动切换」默认关闭，开启后依据真实用量轮转
本期 Token 总量与 API 价值估算、按真实占比分割的阵营对决、每日柱状图、跑过的每一个模型、以及你的岛民段位
可以。两种卡片都支持从日历任选起始日期，一直回溯到你最早的扫描数据
它们是按公开的每 token 价格算出的估算，并且始终标明是估算。你实际付的是订阅费；估算展示的是同样的用量走 API 大约值多少
官方页面通常只计输入+输出。Agent Island 默认统计所有经过链路的 token，包括缓存读取——有开关可以切换成官方口径
不会。复制、保存、分享都由你明确触发，绝不会替你发布任何内容
没有。App 内没有埋点、不用注册、没有分析统计。唯一的网络请求是用你自己的凭据去调各家的用量接口
从各家 CLI 本来存放的位置读取——macOS 钥匙串或本地认证文件——就地使用，绝不上传。当 Anthropic 轮换 refresh token 时，新令牌会原样写回 CLI 期望的位置
能。整个 App 在 MIT 协议下开源——去读那些请求代码、自己编译、自己比对
会话索引、偏好设置与缓存都在你本机的标准应用存储目录里。没有任何云端组件
它读会话文件来判断状态——回合是否结束、会话属于哪个项目、用了多少 token。任何内容都不会外传，对话正文除了会话标题之外不会被上传或展示
不会。扫描是有界且增量的，冷数据会被跳过。持续 CPU 占用在个位数低位
会话状态和提醒完全离线可用——它们读的是本地文件。额度数字需要联网刷新，并会显示上次同步是多久之前
在终端跑一次 claude /login。App 会自动发现最新的钥匙串条目，不需要任何配置
在终端跑 gemini 完成 Google 登录。如果你的账号无法访问 Code Assist，CLI 自己会说明——API key 模式按设计不会点亮这一行
看面板底部的「已同步」时间，点它可以立即刷新。如果凭据过期，那一行会切换成重新认证提示，而不是显示错误数字
Windows 端目前仍是 v1.7.1，马上同步到 2.1.1。它列出的能力对你手上这个版本仍然准确
Homebrew 安装会自动去掉隔离属性。手动装 DMG 的话，从 GitHub Releases 重新下载即可；每次更新在应用前都会验证签名
MIT。随便用、随便 fork、随便发
唐哲宇（Tristan Tang），一个独立开源项目——以及社区提的 issue 和 PR
在 GitHub 上开 issue 或提 PR。可复现的会话样本和跨平台测试尤其宝贵
仪表盘权威但活在浏览器标签里，ccusage 是终端里的报告。Agent Island 是环境式的——实时会话加额度就在菜单栏，全部本地计算。对比页有逐项的事实对照
去 GitHub 点一颗 Star，再分享给身边的朋友——这两件事就是最大的支持