Repository navigation
Every kind of notification now has its own on/off switch — and the context warning that was flooding notifications fires once, the way it was meant to.
The context warning was firing far too often
The "near its context limit" warning is supposed to fire once, when a session crosses 80% of its context window. It kept firing because of a bug.
AgentMenu folds each Claude Code subagent's transcript into its parent session's row, and it took the context reading from whichever transcript had written most recently. So every time a subagent ran, the reading dropped from the session's ~85% to the subagent's few percent, which reset the warning — and the parent's next message pushed it back over 80% and fired it again. The row's context meter jumped around for the same reason.
Replayed over 14 days of real sessions:
| warnings before | warnings after | |
|---|---|---|
| busiest session (82 subagents) | 172 | 5 |
| all sessions | 248 | 18 |
Each of the 18 that remain came after the context had dropped to 3–10% and climbed back up — which is what happens after compacting. Those are genuine warnings.
The context reading now always comes from the parent conversation. A subagent is a separate conversation with its own window; how full it is says nothing about how full yours is.
Claude Code notifications were all labelled "needs permission"
Claude Code reports twelve different kinds of notification. AgentMenu was showing every one of them as "Claude Code needs permission" and lighting the red permission dot — including "waiting for your input", finished subagents, and sign-in or quota notices.
Each notification is now identified by the type Claude Code attaches to it. Only real permission prompts and questions mark a session as blocked; everything else notifies without touching that.
A switch for each notification type
Preferences → Notification types lists six, each with a line explaining when it fires:
- Permission & input requests — an agent is blocked until you approve a tool or answer a question
- Waiting for your input — Claude has finished and is idle at the prompt
- Turn finished — an agent finished replying
- Subagent finished — a Claude Code subagent completed its task
- Context nearly full — a session crossed 80% of its context window
- Other Claude Code notices — sign-in, quota auto-resume, and anything else Claude Code reports
All six start switched on. Anything you switch off stays off across updates, and any new kind added in a later release arrives switched on rather than silently missing.
Each type is also kept separate when notifications are merged to avoid duplicates. Previously they shared one slot, so a "waiting for your input" notice could hide a real permission request that arrived a few seconds later.
Smaller fixes
- Every switch in Preferences now lines up on the right edge, the way macOS System Settings lays them out. The new card made the old layout — each switch sitting right after its own label — zig-zag noticeably.
- A failed API request (a placeholder message with no input) no longer counts as the session's context reading, which could also reset the warning.
311 tests pass, 18 of them new.
Install: download AgentMenu-1.7.0.dmg, open it, and drag the app to Applications. It's ad-hoc signed and not notarised, so macOS blocks the first launch — the README covers three ways past that.