On this page
Desktop Tray
A macOS menu bar app that shows your project momentum at a glance - without opening a terminal or an editor. Optional, but useful if you work across multiple projects.
What it is
The desktop tray is a native Kotlin/Compose Multiplatform app that lives in the macOS menu bar. It's read-only - it displays data written by the CLI, extension, and hooks, but doesn't write any of its own. It's particularly useful for seeing momentum across several projects without switching terminal tabs.
The tray is entirely free and doesn't require a Pro license.
What it shows
Active project
Which project currently has an active session, with the current branch and session duration.
Last checkpoint
Summary and next step from the most recent checkpoint, with timestamp.
Momentum score
A derived score based on recent activity frequency. Higher = more active recently.
Re-entry briefing
Click any project to see a full briefing: recent commits, session history, current task.
Cross-project list
All registered projects ranked by last activity, so you can see at a glance what's been idle.
How it connects
The tray connects to the kgd daemon via a Unix socket at ~/.keepgoing/keepgoing.sock. The daemon watches your project directories for file changes and pushes updates to connected clients (the tray) in real time.
The daemon is registered as a macOS launchd agent by the setup wizard, so it starts automatically at login. The tray also reads SQLite directly as a fallback when the daemon isn't running.
Install
Via Homebrew (recommended):
Or run keepgoing setup desktop-tray. Full instructions at /setup/desktop-tray.