Lunavect

See which Claude Code or Codex session is waiting for you.
Every agent session on your Mac with its live state, right in the menu bar,
next to both tools' weekly and five-hour limits with reset times.

_{Version 0.2.8 · macOS 14 or later · Apple silicon and Intel · Free and open source}

_{The real app with fictional sessions and data.}

Features · Install · FAQ · Website · Release notes

_{If Lunavect helps you catch a waiting agent, a ⭐ helps other Mac developers find it.}

Know which agent needs you

Every Claude Code and Codex task on your Mac in one panel, with its live state:
working, thinking, waiting for permission or input, or done.
Search, filter, pin and hide sessions. Live Terminal and iTerm2 sessions open in their own tab.

Background work, told once

Claude's background commands, subagents and monitors appear as a small count on the session.
A reply that leaves them running stays in the background, and one notification arrives when the work is done.
If a turn fails, Lunavect says why: a reached limit and when it returns, a lost connection, or a sign-in issue.

Usage limits at a glance

Weekly and five-hour allowances for Claude and Codex, with reset times.
Show them in the menu bar as bars, percentages or rings. Unknown values stay unknown.

Stop a session at your share of the week

Two-finger click a Claude Code or Codex session and choose Limit Usage…. Near your level the agent finishes its step
and writes what is done and what is left; at the level its next action is refused. Nothing is killed, and your own message lifts the stop.
Lunavect continues the session after the reset in its own Terminal or iTerm2 tab, or at a time you choose with Continue Later….

Desktop widgets

Limits, activity or both, in small, medium and large sizes.
Choose a solid background or adjustable glass.

See where your time goes

Working time by day, week, month, year and all time for each provider, with a calendar of working days,
the hours you work, projects and sessions. The Agent Monitor shows tokens per session, project and model.
Recovered history is marked as approximate.

Make it yours

Pick the Claude, Codex or Lunavect character, a one-line, two-line or activity-only status,
and playful activity phrases while your agents work.

Also included: notifications when a response is ready, an approval or reply is needed, a turn fails or a limit runs low ·
Keep Awake while agents work · light and dark appearance · English, Russian, German, Spanish, French and Simplified Chinese

brew tap lovach/lunavect https://github.com/lovach/Lunavect
brew install --cask lovach/lunavect/lunavect

git clone https://github.com/lovach/Lunavect.git
cd Lunavect
./scripts/check.sh