Skip to content

Moonglade 0.1.0

Choose a tag to compare

View all tags
@ixjosemi ixjosemi released this 25 Jul 13:42
· 33 commits to main since this release
v0.1.0
This tag was signed with the committer’s verified signature.
ixjosemi Josemi Hernandez
SSH Key Fingerprint: NXmpJON3n/ll/QcynxxR6Of7MuSBzG9oxRrI+DbLtHE
Verified
Learn about vigilant mode.
a3adba3
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Moonglade is a quiet, native macOS indicator for Claude Code, OpenCode, Codex CLI, Pi, and Convoy sessions. It lives around the MacBook notch — a pill on displays without one — and returns you to the exact terminal tab or tmux pane with one click.

What it does

  • Global counts for running, waiting, and blocked sessions, without inferring them from provider icons.
  • Click the summary and a wide session menu grows out of the notch: provider, status light, session title from the live terminal tab, project directory, git branch (worktrees included) or Convoy pipeline step, and elapsed time.
  • One click focuses the recorded Ghostty, cmux, iTerm2, Terminal, or tmux session.
  • Expand a row for inline actions: rename, copy the project path, reveal in Finder, kill the process — SIGTERM escalating to SIGKILL — or close its exact tmux pane or Ghostty tab.
  • Convoy pipeline runs are first-class sessions: current step in the row, red light on human gates, no duplicate rows for the OpenCode sessions a pipeline owns.
  • Closed terminals disappear immediately through kernel exit notifications, with a five-second scanner and reaper backstop.

Everything is event-driven and off the main thread: a libproc scanner at ~2 ms per sweep on a five-second heartbeat, EVFILT_PROC exit watchers, and debounced directory observation. Idle cost is roughly 1% CPU and 16 MB.

Privacy

No networking, no telemetry, no accounts, no third-party Swift dependencies. Session metadata stays in ~/.moonglade/state with user-only permissions. Prompts and model responses are never stored. See PRIVACY.md.

Install

This release is source-only — there is no signed or notarized binary, so nothing here to download and run. Build it:

git clone https://github.com/ixjosemi/Moonglade.git
cd Moonglade
./scripts/install.sh

One command builds the app, installs it into /Applications, wires the agent hooks, launches it, and verifies the result. The same command reinstalls. Verify at any time with moonglade doctor.

Requires macOS 14 Sonoma or newer (macOS 26 for the real Liquid Glass backdrop), Swift 6.0 to build, and a notched MacBook for the intended placement. Apple Silicon is the tested platform; Intel is not yet validated.

Known limitations

  • No signed or notarized binary, no automatic updater, no Homebrew cask.
  • Codex rollout formats are not a stable contract; unknown lines are ignored and the notify hook is the reliable turn-complete signal.
  • Same-directory Codex sessions can be ambiguous when upstream events carry no PID or terminal identifier.
Assets 2
Loading