[aretelew]

What changes

Before: the menu bar item grew inline Days / Hours / Minutes pills while you typed a time, and status, warnings, Settings and Quit lived in a right-click menu. Settings was one long scrolling form.

After: the menu bar shows only the eye (closed when idle, open with a short countdown during a session). Any click on it, left or right, opens one fixed-width popover with the status line, preset chips and a Custom row (Days / Hours / Minutes with a Start or Extend button that stays disabled until the time is valid), hold-to-end, the Mac's status and warnings, a battery row with time to empty or to full, and Settings and Quit at the bottom. Settings is now a window with a sidebar of panes and a search field that jumps to and highlights the matching setting, with searchable lists, an installed-app picker, typed number boxes, and info buttons for long explanations.

How:

• Design tokens. DesignTokens and HoverHighlight hold the shared sizes, colours and hover treatment; BrandPalette names its colours by role.
• Battery row. PowerMonitor.readTimeRemaining() reads the internal battery's time to empty or to full from the power source list, or reports that it is still calculating.
• Popover. StatusPopoverView replaces the right-click menu and PillView; StatusMenu and StatusSource now build rows for it. Warning lines lose their inline ⚠ because the row draws one. A start or extend in flight no longer shows "Sleep still held with no session".
• Popover height. Everything above the footer scrolls once it would pass the screen's usable height, so Settings and Quit stay visible however many warnings there are.
• Clicks. StatusItemController keeps its own open/closed state, so every click flips the popover at once, however fast. The popover never animates and is closed by the controller's own mouse-down monitors. A click on the item is not counted as both a click outside and a reopen. KeyCatcherPanel is gone.
• Settings. SettingsPanes splits the window into panes with search; the lid-close notice now points at the Lid close pane. Pane names are sentence case. Each editable list (presets, freeze list, agent apps, tmux targets) has a search field and a + button; for app lists the + opens a picker of installed apps with their icons. The battery floors and the tmux nudge delay are typed into small boxes instead of steppers. The hotspot name and password are bordered fields saved by one Save button. Long explanations sit behind info buttons (a help tag on hover, the full text in a popover on click), and search still finds their words. The sidebar opens wide enough to fit every pane name.
• Docs. README and the UI section of docs/spec.md describe the popover and the new Settings.

How it was tested

• swift build -c release -Xswiftc -warnings-as-errors succeeds at the head commit (Xcode 27.0).
• swift test at the head commit: 1,282 tests, 13 skipped (tmux is not installed on this Mac), 1 failure: AppEncodedJournalScriptTests.testAnEscapedNameOrUIDDoesNotStopTheAgentAndTheAppRestoresIt, which passed twice when rerun alone. This branch does not touch scripts/.
• Tests added or rewritten for the popover (UIStatusTests, UIStartupTests, StatusMenuWarningTests) cover fast clicks, clicks outside, fixed width and wrapping, chips, the Custom row's validation, and the start/extend flows. SettingsSearchTests covers Settings search.

Real-Mac evidence

Not posted yet. This changes Sources/, so a real-Mac report for the head commit will follow as a comment after the last push.

Confidence Score: 5/5

The latest changes appear safe to merge; no new actionable issue was found.

Summary

This PR moves session controls and status into one menu bar popover and splits Settings into searchable panes.

• The menu-bar eye opens one popover for time controls and Mac status.
• Settings groups controls into searchable panes and easier-to-edit lists.
• Sessions check that macOS still has sleep disabled.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Open popover] --> B[Read configured hotspot name]
    B --> C[Check saved password without a prompt]
    C --> D[Keep newest answer]
    D --> E{Answer matches current name?}
    E -->|No| F[Leave readiness row out]
    E -->|Yes| G{Password warning already shown?}
    G -->|Yes| H[Show existing warning]
    G -->|No| I[Show off, missing setup, or ready]

Loading

_{Reviews (9) · Last reviewed commit: "Popover: show whether hotspot failover i..." · Reviewed by Greptile}

[krishhgg]

For @krishhgg (the owner) to see what the changes look like. The maintainer's tooling made these in a macOS 27.0.1 VM. This is not a review and not a merge decision.

Setup. A macOS 27.0.1 VM on the maintainer's Mac mini. "After" is this PR's head 4709a86, built as is. "Before" is main 8302ee8. Both start from the same default config. The VM has no battery, so the battery row never shows.

Popover, start to end

Click the eye and pick 2h. The header reads "Starting…" for about 5 s, then "Awake until 07:55, 1h 59m left". With the popover closed the menu bar shows only the eye. Reopen it and hold the ring to end the session.

Menu bar

	main	this PR
Idle
Session running

main shows a countdown and a × next to the eye. This PR shows the open eye alone.

Clicking the eye

main, left click: Days, Hours and Minutes fields open right in the menu bar.

main, right click: a menu with status, Settings and Quit.

The same menu during a session:

This PR, left or right click: one popover.

Popover, light and dark

	Light	Dark
Idle
Session running

While a session runs, the chips change to +30m, +1h and Custom, and "Hold to end the session" appears.

Custom time

Empty, with the hover tip	75 in Hours: Start stays grey	2 hours: Start turns blue

Settings

Click through the six panes, type "mute" in the search and click the result. It jumps to Lid close and tints the row.

main's Settings is one long form:

This PR's panes:

General	Sessions
Lid close	Agent apps
Battery & thermal (number boxes)	Network

Search results, then the jump after clicking one:

The + on an app list opens a picker of installed apps:

An ⓘ button opens the full text in a popover:

What looked odd

• The PR body says the eye is "open with a short countdown during a session". This build shows the open eye with no countdown. The comment in StatusRootView.swift agrees with the build: the time left lives only in the popover.
• When the popover opens, a blue focus ring sits on the 30m chip or on Settings….
• With 75 in Hours, Start goes grey. The field's red error border sits inside the blue focus ring and reads as a thin purple line. No text says what's wrong.
• After a chip click the header says "Starting…" for about 5 s and the chips are greyed out.
• The search jump scrolls "Mute audio on lid close" only to the bottom edge of the window.
• Agent apps that aren't installed are named from the last part of their bundle ID: "app" for com.conductor.app, "reasoning" for com.t3tools.t3code.reasoning.
• The "Sleep held per journal" row shows during every session in this VM. main shows it too.

Files: pr-evidence 202ef0f, folder macos-27.0.1/pr-118-tour/.

🤖 Generated with Claude Code

[greptile-apps]

Want your agent to iterate on Greptile's feedback? Start a greploop in Claude Code and it will work through the open comments and keep going until this PR reviews clean.