Lunavect: Keep Claude Code and Codex Sessions in View on Mac

Lunavect is a native macOS companion for keeping Claude Code and Codex work visible while you move between projects. It collects session status, terminal entry points, and usage indicators in one menu-bar view instead of asking you to remember which window is waiting.

The latest official release is v0.2.8, published 2026-09-30. The app supports Apple Silicon and Intel Macs running macOS 14 or later; its integrations depend on the official Claude Code and Codex clients or command-line tools being present.

See coding-agent sessions in one place

Lunavect lists Claude Code and Codex sessions with states such as working, thinking, waiting, and done. You can search and filter the list, pin important sessions, and hide entries that are no longer useful in the overview.

The menu-bar summary is meant to make the state legible at a glance, while the fuller popover keeps project and session details close. It is a companion to the agents’ own interfaces, not a replacement for their editors or terminals.

Return to the right terminal or session

When a session needs attention, Lunavect can open the related terminal or iTerm tab. Search, filters, pinning, and hiding help keep the list manageable when several repositories or agents are active at once.

The app can also count background commands, subagents, and monitors, and surface a completion notification. That gives you a lightweight way to notice parallel work without keeping every terminal in the foreground.

Tell active, waiting, and completed work apart

Session states help answer the practical question: is the agent still working, waiting for input, or finished? The menu-bar view and notifications reduce the need to switch through windows just to check for a result.

Lunavect also shows time breakdowns by project and session. These are visibility tools for your own workflow; they do not judge code quality or guarantee that a task is complete just because a session is marked done.

The signal depends on the official client and the integration data available locally. Treat the status as an aid to navigation, then review the actual conversation, terminal output, and changed files before accepting an agent’s work.

Understand five-hour and weekly usage windows

The dashboard can show five-hour and weekly allowances, reset timing, and progress as bars, percentages, or rings. Seeing the next reset alongside active work can help you decide whether to continue now or plan around a later window.

Usage context is shown locally for the connected tools, with breakdowns that can help explain where time went across projects and sessions. The counters are a companion view, not a substitute for checking the account and quota details shown by Anthropic or OpenAI.

Continue Later is a local workflow, not a provider-side cap

Version 0.2.8 adds usage-limit scheduling for running agent tasks and a Continue Later flow. You can arrange for a task to pause before a five-hour window runs out and continue after the reset, which is useful when you do not want to keep watching the clock.

The release notes describe a hook-based workflow that preserves the task’s files and conversation and does not kill the process. This is local coordination around your session; it should not be mistaken for Claude or Codex enforcing a new server-side quota or guaranteeing a particular provider reset.

The official clients remain responsible for sign-in

Lunavect does not require its own account or API key. It works with the official Claude Code CLI and official Codex app or CLI, so authentication continues to happen through those tools rather than through a separate Lunavect login.

The maintainer says session titles, project paths, and activity history stay on the Mac and are not sent to the developer; the app also checks GitHub for updates. That is the project’s privacy description, not an independent audit, so consult the source and release notes if your environment has stricter requirements.

Because the app surfaces agent sessions and usage indicators, confirm that the relevant CLI or desktop client is installed and signed in. Lunavect can present the local information it receives, but it cannot create access to an account or provider feature you do not already have.

Compatibility and languages

The documented baseline is macOS 14 or later on Apple Silicon and Intel. The interface is available in English, Russian, German, Spanish, French, and Simplified Chinese.

Lunavect is a Swift macOS app and the repository includes its source and tests. Its session and usage integrations are designed around the official Claude Code and Codex clients rather than asking you to paste a separate service credential into Lunavect.

The app helps observe and organize local agent work. It does not promise to increase a provider’s quota, change reset times, or make every session controllable from the menu bar.

Install the official v0.2.8 DMG

We did not find a matching Mac App Store listing in the project’s distribution links or Apple’s catalog. For the ready-to-run app, download the official Lunavect v0.2.8 DMG, open it, and move Lunavect.app to Applications. The project says its releases are Developer ID signed and notarized.

open 'https://github.com/lovach/Lunavect/releases/download/v0.2.8/Lunavect-0.2.8.dmg'

Open source, with a practical boundary

Lunavect is published under the MIT License. The GitHub repository includes the source, release notes, and current installation files; third-party notices are documented separately.

Who should try Lunavect?

It is useful if you run Claude Code or Codex across several projects and want a compact way to see session state, return to the right terminal, and keep an eye on usage windows. Continue Later may help organize work around those resets.

It is less useful if you need a standalone agent, a new provider login, or a tool that changes account quotas. Start with the official clients installed and authenticated, then use Lunavect as a local dashboard and workflow companion.

# Open the official v0.2.8 DMG:
open 'https://github.com/lovach/Lunavect/releases/download/v0.2.8/Lunavect-0.2.8.dmg'