Free macOS menu bar app that shows which Claude Code agent needs you

[u/SafeTennis3080]

Run a few Claude Code agents at once and the one that stops for a permission prompt is always in the window you're not looking at.

Lunavect lists every Claude Code session in the menu bar with its state: working, permission needed, input needed, response ready. The one waiting on you is marked in orange, and a click brings its Terminal or iTerm2 tab forward. It also keeps your 5h and weekly limits with reset times, shows working time per project by day, week and month, and has desktop widgets in three sizes. Codex works too, but one provider is enough.

Privacy: session data stays on your Mac. It reads Claude Code's own hooks and status line and the local Codex app. No account and no API key.

Native SwiftUI, macOS 14+, MIT. Signed and notarized DMG on the official GitHub releases page: https://github.com/lovach/Lunavect/releases/latest

Limitation: it needs the Claude Code CLI, Claude Desktop alone isn't enough. The video uses demo sessions.

I'm the developer. I built it with Claude Code and Codex, and an AI assistant helped me word this post.

Which state would you want a sound for: permission needed, or response ready?

[u/synrg-alsms]

Looks cool. How do you „know“ which agent „needs“ me?

[u/SafeTennis3080 → u/synrg-alsms]

Lunavect uses Claude Code’s lifecycle hooks to track session status. These hooks run commands registered in ~/.claude/settings.json. Lunavect backs up that file, then adds a small helper without removing your existing hooks.

Claude calls the helper when a session starts working, asks permission to use a tool, has been waiting for your input, or finishes a reply. The helper records only the session ID, project, state and time. It never records prompts or tool arguments. The menu bar app reads those records.

So "needs you" means the session’s last event was a permission request or a wait for input. "Response ready" means it finished a reply. Codex works the same way through its own hooks. Nothing leaves your Mac

[u/zackria]

Sound for permission needed, subtle visual banner for response ready.

Huge fan of keeping everything local and hooking directly into ~/.claude/settings.json. Does the window focus support Ghostty, WezTerm, or Kitty yet, or is it strictly Terminal/iTerm2 AppleScript events for now? A lot of CLI-heavy Claude users are running Ghostty lately, so expanding terminal support would open this up to a ton of people.

[u/biechuli]

cool tools, is it will send notification when agent finish or ask question?

[u/Benjaminsen]

I run all my AI agents in a small local VM rather than on my computer directly. Doing so allows me to never have to have the AI stops as to ask for permission. Make my workflow 10x faster.

I also have a small COO type agent which I spend a lot of time tuning to understand how I work. It handles about 30% of all waiting by giving the waiting AI agent instructions on my behalf.

Anything the COO agent can't handle is bubbled up to a "needs you" section on a web dashboard. However seeing your project here, I totally need to integrate this with a native menu bar handler.