按头安利：Agent Island —— 发完一轮去生活，该你了它会叫你

GitHub：tristan666666/agent-island
官网：agent-island.dev
平台：macOS 13+（SwiftUI，Apple Silicon + Intel）| Windows 10+（WPF）
安装：brew install tristan666666/tap/agentisland
许可：MIT

它解决的那个真实问题

你把任务扔给 Claude Code 或 Codex，然后……等。
等它转，等它转，偶尔回来看一眼，发现它早就停了，配额也到顶了，等了两小时什么都没发生。

或者反过来：你去做别的事，回来后不知道它跑完了没有，打开 terminal 才发现十五分钟前就停了。

Agent Island 就是为这件事造的——让 Agent 工作，你去生活；它转完，叫你；配额回来，自动续命。

它住在哪

Mac：住在 MacBook 的刘海（notch）里，不占 Dock 也不占菜单栏。非刘海机型（Intel、Mac mini、外接显示器）可切换为紧凑顶栏模式。

Windows：原生 WPF 应用，同款检测引擎，顶栏模式或浮动小部件（可拖拽，记住位置），托盘图标常驻显示用量圆环。

两端都是纯原生——Mac 是 SwiftUI，Windows 是 WPF，没有 Electron。

四件核心事

1. 实时状态，一眼知道 Agent 在不在干活

刘海/顶栏里的 Claude 和 Codex 图标，随时镜像真实状态：

图标状态	含义
旋转	有 session 正在工作
静止	没有任何 session 运行，或这轮刚结束（该你了）
红色脉冲	需要你处理：限速 / 登录失效 / 网络 / provider 报错

检测是事件驱动的（Mac 用 FSEvents 监听 transcript 文件），状态变化在 Agent 真实停止约 1 秒后就体现出来，不是轮询。

2. 「该你了」闹钟

一轮结束时：

弹出前台闹钟窗口
发送系统通知
播放提示音（内置多个选项，或导入自己的音频文件）

几个细节做得很好：

回复即消失：你在线程里一回复，闹钟自动关掉，不会留着烦你
多轮排队：如果你没注意，连续结束的多轮会排队显示，不会吞掉
直接跳转：Codex session 通过 codex://threads/… 跳到对应线程；Claude CLI session 用 claude --resume 恢复；Claude Desktop 直接把窗口拉到前台

3. 配额耗尽专用闹钟

「轮结束」和「配额到顶」是两件不同的事，Agent Island 给它们各自的闹钟。

配额耗尽时，闹钟上直接显示重置时间——比如「Resets at 15:55 (~2h)」。你不用再去找 Claude 的设置页算几点能用。

有防骚扰设计：启动时如果配额已经是耗尽状态，不触发（只在这次耗尽事件本身触发一次）。

4. 配额重置自动续命

这是最硬核的功能。

给某个 session 绑定一个规则：当 Claude 或 Codex 的使用窗口重置时（或按固定间隔），自动发一条消息（continue / OK / 你自定义的内容）让它继续跑。人不在，夜里它自己续上。

内置的安全机制：

全局开关：Settings 里关掉，任何自动续命都不会触发
目录白名单：续命只对你显式允许的项目目录生效
运行记录：每次执行或拦截都有日志，从 Settings 直接打开文件夹查

诚实说明：Mac 必须处于唤醒状态，每次续命都会消耗 token。

用量岛：配额 + 费用 + 倒计时

刘海里有一块「用量岛」，可滑动翻页，直接显示：

Claude / Codex 的 5 小时窗口和周用量百分比
已花费金额
重置倒计时

Claude 登录失效时，Re-authenticate 按钮直接在浏览器打开 claude.com 授权页，拦截回调——不用开 terminal，不用粘贴 code。

安装

macOS（推荐 Homebrew）：

brew install tristan666666/tap/agentisland

或直接下载 DMG：最新 Release

首次打开如果 macOS 提示”未经验证”（App 暂无 Apple 开发者账号公证），右键 → 打开一次即可。

Windows：

# Scoop
scoop bucket add agent-island https://github.com/tristan666666/scoop-bucket
scoop install agent-island/agentisland

# winget
winget install TristanTang.AgentIsland

或直接下载 AgentIsland-win-x64.zip，解压运行 AgentIsland.exe。

技术背景

Agent Island fork 自 codex-island（Eric Park 的工作，提供了用量计量和费用统计基础）。

在此之上新增：

FSEvents 事件驱动的 session 状态检测
轮结束 / 配额耗尽双闹钟系统
Auto-resume 自动续命机制
macOS 双布局 + Windows WPF 移植

检测原理：读取 Claude Code、Claude Desktop、Codex 在本机写入的 transcript 文件，识别 stop_reason: end_turn（Claude）和 task_complete（Codex）等结束标记。没有遥测，没有数据上传，一切在本地运行。

适合谁用

重度 Claude Code 用户：同时跑多个 session，需要知道哪个轮到了
Claude + Codex 混用用户：两个配额都要盯，自己算太烦
有夜间/后台任务需求：扔给 Agent 跑，自己去做别的，结束了被叫回来
想最大化配额利用率：不等 Agent 发呆，配额一回来立刻续命

GitHub：github.com/tristan666666/agent-island
官网：agent-island.dev

Must Have: Agent Island — Start the Run, Go Live Your Life

GitHub: tristan666666/agent-island | Website: agent-island.dev
macOS 13+ (SwiftUI) | Windows 10+ (WPF) | MIT License
Install: brew install tristan666666/tap/agentisland

The Problem It Solves

You kick off a Claude Code or Codex run, then go do something else — and miss the moment it stopped. Or you sit there babysitting it. Neither is great.

Agent Island’s pitch: start the run, go live your life. It calls you when it’s your turn.

Where It Lives

On Mac: inside the MacBook notch (or compact top bar for non-notch machines). On Windows: native WPF top bar or floating widget. No Electron on either platform.

Four Core Things

1. Live session state in the notch.
Claude and Codex logos spin while sessions run, go still when done, pulse red when something’s wrong. Detection is FSEvents-driven — ~1s latency from real stop.

Logo	Meaning
Spinning	Session active
Still	Idle / turn finished
Red pulse	Error / rate limit / auth issue

2. “It’s your turn” alarm.
When a turn finishes: alarm window + system notification + sound. Dismisses automatically when you reply. Multiple finished turns queue.

3. Out-of-quota alarm.
Different event, different alarm. Shows the reset countdown: “Resets at 15:55 (~2h)” — so you know exactly when to come back.

4. Auto-resume on quota reset.
Attach a rule to a session: when Claude/Codex’s usage window resets (or on a schedule), Agent Island sends a message (continue, OK, whatever you set) to pick the work back up — unattended, while you sleep.

Safety controls: global kill switch, per-project directory allow-list, full run log.

Usage Island

Swipeable pages in the notch: live Claude + Codex 5-hour / weekly usage, cost, and reset countdowns. Re-auth button for expired Claude sessions opens the real authorize page in your browser — no terminal needed.

Install

# macOS
brew install tristan666666/tap/agentisland

# Windows (winget)
winget install TristanTang.AgentIsland

Or grab the DMG / zip from releases.

How It Works

Reads the transcript files Claude Code, Claude Desktop, and Codex write locally. Detects stop_reason: end_turn (Claude) and task_complete (Codex). Calls provider usage APIs with your existing local credentials. No telemetry, no data upload.

Fork of codex-island (usage/cost foundation by Eric Park) — adds session state detection, turn alarms, auto-resume, and Windows.

GitHub: github.com/tristan666666/agent-island

按头安利：Agent Island —— 发完一轮去生活，该你了它会叫你

Must Have: Agent Island — Start the Run, Go Live Your Life

它解决的那个真实问题

它住在哪

四件核心事

1. 实时状态，一眼知道 Agent 在不在干活

2. 「该你了」闹钟

3. 配额耗尽专用闹钟

4. 配额重置自动续命

用量岛：配额 + 费用 + 倒计时

安装

技术背景

适合谁用

Must Have: Agent Island — Start the Run, Go Live Your Life

The Problem It Solves

Where It Lives

Four Core Things

Usage Island

Install

How It Works

相关文章

💬 评论与讨论