Claude Code and Codex in your Mac menu bar: see which AI coding agent is working or waiting for you, track weekly and 5-hour usage limits, and add desktop widgets. Free, open source, native macOS.. It is open-source on GitHub.

Is Lunavect free to use?

Lunavect is open-source under the MIT license, so it is free to use.

What category does Lunavect belong to?

Lunavect is listed under automation in the Claudeers registry of Claude-compatible tools.

Platforms	cli, api, desktop, web
Operating systems	—
AI compatibility	claude
License	MIT
Pricing	open-source
Language	Swift

Lunavect

The menu bar companion for Claude Code and Codex on your Mac.
See which AI coding agent is working, which one is waiting for you
and how much of your weekly and five-hour usage limits is left.

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

Lunavect in the macOS menu bar: the session panel lists nine Claude Code and Codex tasks, eight working and one waiting for permission, beside a desktop widget with weekly usage limits and a week of activity

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

Features · Install · FAQ · Website · Release notes

Features

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.

Three Lunavect session panels: all nine tasks, a search for “bill” showing one Claude task, and the waiting filter showing the task that needs permission

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.

Claude 68% and Codex 54% of weekly usage left, shown in the menu bar as bars, percentages and rings, in the Remaining popover with reset dates and in a small desktop widget

Desktop widgets

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

Five Lunavect WidgetKit widgets on glass: overview with limits and activity chart, weekly limits, weekly activity chart, and small limits and activity widgets

See where your time goes

Working time by day, week and month for each provider,
with project and session breakdowns. Recovered history is marked as approximate.

Lunavect statistics window: a week of Claude and Codex working time with a daily chart

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.

Menu bar status styles with the Claude, Lunavect and Codex characters above the Menu Bar settings, where the character and status style are chosen

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

Install

With Homebrew

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

Or download Lunavect-0.1.9.dmg, open it and drag Lunavect to Applications. Every release is Developer ID signed and notarized by Apple, and updates arrive through Settings → Updates.

Then choose Connect Claude or Connect Codex. Claude needs Claude Code CLI; Claude Desktop alone is not enough. Codex needs the official Codex app or CLI. Connect one provider or both. Sign-in stays with the official clients.

Setup, updates and uninstall · Compatibility and known limitations

FAQ

Can I use only Claude Code or only Codex?

Yes. Connect either provider or both. Claude needs Claude Code CLI; Claude Desktop alone is not enough.

Do I need an account or an API key?

No Lunavect account or pasted API key is required. Sign-in stays with the official clients, and the available allowances depend on your plan.

Why is a limit unavailable or a widget behind the app?

Limits need fresh data from the client, and missing or expired values are shown as unavailable instead of guessed. Widgets read saved data and refresh when macOS schedules them. Check Connections and the timestamp of the value.

Is activity the same as token usage?

No. It measures working intervals. Recovered history is marked ≈, and overlapping sessions are counted once in the combined total.

Does Lunavect send my sessions anywhere?

No. Session titles, project paths and activity history stay on your Mac. There is no account system or analytics backend; update checks go to GitHub without session data.

All questions and answers · Installation and troubleshooting

Privacy

Lunavect reads local client data and adds its event handlers when you connect a provider, keeping unrelated configuration intact. It extracts only session identity, state and timing, and never saves a copy of your conversations. Privacy and permissions · Connection details · How activity is counted

Development

Requires full Xcode and a compatible Swift toolchain.

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

The check runs the tests and builds the universal Release app, helpers and WidgetKit extension without a signing account. Contributing · Development guide · Documentation · Security reports

Bug reports should include the macOS version and steps to reproduce; remove private session titles, paths and credentials from attachments. Ideas are welcome in Issues.

License

MIT for original Lunavect code. Third-party software and artwork are covered in NOTICE. Lunavect is independent of Anthropic and OpenAI.

Lunavect

Install with your AI

// compatibility

Lunavect

Features

Know which agent needs you

Usage limits at a glance

Desktop widgets

See where your time goes

Make it yours

Install

FAQ

Privacy

Development

License

// faq

// embed badge

// retro hit counter

// reviews

// guestbook

// related in Automation & Workflows