[AaronWong1999]

abtop already shows how much of the 5-hour window Claude and Codex have left. When one of them is about to run out, the next step for many people is to switch to the other agent, and then explain the whole task again. ccx is a macOS menu bar app that does that hand-off with the full context: messages, task list, condensed tool output and git status, kept in sync both ways. With abtop on the PATH, ccx now uses abtop's numbers. When either side's 5-hour window passes 90%, or is used up, it notifies once and offers that side's newest session to continue in the other agent in one click. So for abtop users, a near-full limit bar becomes a one-click next step instead of a wait for the reset.

How ccx uses abtop: it runs abtop --json at most once every 5 minutes. It reads only rate_limits[]: source, five_hour_pct, five_hour_resets_at and five_hour_window_minutes, plus seven_day_pct and seven_day_resets_at to detect a used-up weekly window. A resets_at of 0 is treated as unknown. It doesn't read sessions, prompts or files. Since --json uses tick_no_summaries(), it never spawns claude --print. Without abtop nothing changes, and Claude's numbers appear once the user has run abtop --setup. This shipped in ccx v0.0.33 (MIT, everything local).

The change is a three-line sentence after the abtop-web-ui mention in "Library / JSON snapshot". The README test in src/snapshot.rs still holds, since no existing text changed.

🤖 Generated with Claude Code