Skillget

Lunavect

agent
Security Audit
Fail
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Fail
  • exec() — Shell command execution in Tests/Scripts/test_distribution_registration.py
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Claude Code and Codex sessions in your Mac menu bar: working, waiting for you, done.

README.md
Lunavect icon

Lunavect

A macOS menu bar app and desktop widgets for Claude Code and Codex.

Download Lunavect for macOS — DMG

macOS 14+ · Apple silicon & Intel · Free and open source

Sessions · Usage limits · Widgets · Install · Release notes

Lunavect session panel beside weekly usage limits and daily activity for Claude Code and Codex

Current interface, captured on September 14, 2026 with fictional data. About the screenshots.

Install

Install with Homebrew

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

Or download the DMG and drag Lunavect to Applications. The release is Developer ID signed and notarized by Apple.

Open Connect Claude or Connect Codex in Lunavect. Claude requires Claude Code CLI; Claude Desktop alone is not enough. Connect either service or both. Sign-in stays with the official clients.

Setup, updates and uninstall · Compatibility and known limitations

Screenshots

Sessions

See which task is working, needs input or has finished.

Search by session or project. Filter, pin, reorder and hide sessions.

Claude Code and Codex session panel in light appearance Claude Code and Codex session panel in dark appearance

Usage limits

Weekly and five-hour allowances, with a reset time for each provider.

Missing or expired limits stay marked as unavailable.

Usage settings showing weekly and five-hour remaining allowances and reset times for Claude and Codex

Desktop widgets

Small, medium and large layouts for limits, activity or both.

Choose a solid background or adjustable glass in Settings → Widgets.

macOS manages placement and refresh; glass is experimental and off by default.

Compact weekly limits above an activity chart with detailed hour labels Activity widget with full duration values and daily history

Weekly remaining allowances and reset countdowns Small activity widget with readable provider totals

Activity

Working time by day, week and month, with project and session breakdowns.

Recovered history is marked as approximate.

Activity statistics with provider totals, a daily chart, recovered history and project navigation

Menu bar

Choose bars and percentages, compact icons and percentages, or rings.

The compact mode removes the bars and reduces the height of the indicator.

Three native menu-bar limit styles: bars and percentages, icons and percentages, and rings

Make it yours

Choose a character and session-status style, or let Lunavect pick the character automatically.

Activity phrases switch after two dot cycles. Input and approval requests take priority.

Menu-bar settings with all character choices visible and configurable session status

All images open at full resolution when clicked. Session names, paths and usage values are samples.

FAQ

Can I use only Claude or only Codex?

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

Do I need another account or an API key?

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

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

Limits need fresh data from the client. Widgets read saved data and refresh when macOS schedules them. Check Connections and the value's timestamp.

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.

All questions and answers · Installation and troubleshooting

Data and connections

Session titles, project paths and activity history stay on your Mac. Lunavect reads local client data and configures event handlers when you connect a service. It has no account system or analytics backend. Update checks go to GitHub without session data; the official clients make their own network requests.

Activity measures working intervals. Recovered history is marked as approximate. Missing or expired usage limits remain unavailable.

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 tests and builds the universal Release app, helpers and WidgetKit extension without a signing account.

Contributing · Development guide · GitHub Actions · Release checks

Bug reports should include the macOS version and steps to reproduce. Remove private session titles, paths and credentials from attachments. For testing on another Mac, use the first-install checklist. Feature requests are welcome in Issues.

Documentation · FAQ · Security reports

License

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

Reviews (0)

No results found