WXGopher

Atoll — Development skill for Claude Code

Development community

Windows-native agent session monitor & approval hub for Claude Code and Codex.

How to install Atoll

This entry records only its repository, not the path inside it, so there is no exact command to give. Open WXGopher/atoll and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Atoll does

Windows-native agent session monitor & approval hub for Claude Code and Codex.

Alternatives in Development

Ccmanager — 940+ Session manager supporting 8 coding agents with smart auto-approval 946 ★
Claude Code Zh Cn — Claude Code CLI 简体中文本地化 / 汉化插件；支持 macOS、Linux、WSL、Windows 与新版 native，一行安装，更新后自动修复 721 ★
Harness Remote — Native-session control plane for Codex, Claude Code, OpenCode, OMP and PI 356 ★

README

Atoll

[中文](#中文) · [English](#english)

中文

**在 Windows 任务栏查看 Claude Code 和 Codex 的剩余额度，悬停预览待办，点击查看会话详情，并直接处理工具审批。**

Atoll 通过 Claude Code / Codex hooks 和 Codex 本地会话日志跟踪活动。平时只在任务栏显示简洁的额度与状态，需要时展开详情或审批卡片。

Atoll 详情面板：会话状态和额度窗口

功能

任务栏额度与状态：显示每个代理最紧张的额度窗口，以及等待处理、运行中、已完成的会话数量。颜色阈值可在设置中调整；仅等待或运行状态需要动画。
按活动显示代理：启动时恢复上次保存的代理显隐、额度和会话文本，不主动刷新额度。收到 Claude hook 或新的 Codex 日志事件后更新，并隐藏连续十五分钟没有活动的代理；再次活动时自动显示。点击详情不会触发额度请求。
详情面板自动收起：点击任务栏控件或托盘图标展开；点击桌面、其他窗口，或切换到其他窗口后自动收起。再次点击 Atoll 图标也能关闭。
悬停预览待办：停留在任务栏控件上可预览等待处理的会话，不抢键盘焦点；移开后自动收起，点击可展开完整详情。
Codex 会话自动识别：每两秒读取本地日志中的开始、完成和中断事件，支持从旧日志目录恢复的会话。启动时先建立日志基线，新的事件到来后更新显示；进入实时状态后，连续十五分钟没有活动的会话会从列表移除。
Claude Code 审批卡片：允许或拒绝工具调用，回答 AskUserQuestion。已被你的权限设置允许的工具调用不会弹出审批卡片。
Codex 审批与终端信息：可选安装 Codex hooks，在真实 PermissionRequest 上允许或拒绝工具调用，并记录终端来源用于跳转。Codex 的结构化提问回复和桌面端精确会话跳转仍在计划中。
后台完成通知：观察到任务持续至少三十秒并完成后，发送静音 Windows 通知。不会补发历史完成、中断或短任务；正在查看详情或对应终端时也不提醒。设置中可关闭，Atoll 运行期间点击通知可返回会话或详情。
返回会话终端：对有终端信息的会话，点击详情行可定位 Windows Terminal 或 VS Code 中对应的终端。无法定位终端的会话行不会显示可点击提示。
设置与托盘：支持开机启动、按代理显示或隐藏任务栏内容、修改颜色阈值。右键任务栏控件或托盘图标进入设置或退出。
任务栏集成：跟随任务栏位置、自动隐藏和通知区域大小变化；嵌入失败时使用贴近任务栏的浮动显示。重复启动 Atoll 会替换旧实例。
额度读取：Claude Code 使用其已有凭据读取额度，并尽量复用本机缓存；Codex 从本地 rollout 日志读取额度。请求受限时会退避重试。