Four projects, one menubar. Know where you left off in each.
You switch between projects constantly. The Desktop Tray sits in your macOS menubar and shows re-entry briefings for all of them, no editor required.
How it works
Checkpoints are saved by another tool
The VS Code extension, MCP server, or CLI writes session checkpoints to a .keepgoing/ folder in your project.
Projects are discovered automatically
The tray scans your home directory for git repos with a .keepgoing/ folder. You can also pin projects manually via ~/.keepgoing/tray-config.json.
Get briefings from the menubar
Click the KeepGoing icon in your menubar to see re-entry briefings for all configured projects at a glance.
Features
Re-entry briefings for all projects
See what you were working on, your next step, and how long you have been away for every configured project, all from the menubar.
Multi-session awareness
Track multiple active coding sessions across projects. All users see per-project session counts with 60s auto-refresh. Session Awareness unlocks full detail rows, real-time updates, and desktop notifications.
Full detail, real-time updates, and notifications require Session Awareness add-on · Learn more
Cross-session intelligence
Detect file conflicts and branch overlap when multiple sessions are working in the same project.
Requires Session Awareness add-on · Learn more
Editor-agnostic
Works with any editor or tool that writes to the .keepgoing/ folder. Pair it with VS Code, JetBrains, Claude Code, or the CLI.
Configuration (optional)
The tray auto-discovers git repos with .keepgoing/ data. To pin specific projects or override display names, create ~/.keepgoing/tray-config.json:
{
"projects": [
{
"name": "my-app",
"path": "/Users/you/projects/my-app"
},
{
"name": "side-project",
"path": "/Users/you/projects/side-project"
}
]
}
Each project entry needs a name (display label) and path (absolute path to the project root where .keepgoing/ lives).
Prerequisites
The Desktop Tray reads checkpoint data but does not create it. You need at least one of these tools to start capturing checkpoints.
Install for macOS
macOS only. Choose your preferred installation method.
Homebrew
recommended
Installs cleanly with no Gatekeeper warnings. Updates with brew upgrade.
$ brew tap keepgoing-dev/tap
$ brew install --cask keepgoing
Direct download
Download the DMG and drag to Applications.
Download DMGGatekeeper note
This app is not code-signed. After dragging to Applications:
- macOS 14 and earlier: Right-click the app and select Open.
- macOS 15 Sequoia+: Go to System Settings > Privacy & Security, scroll down, click Open Anyway. Or run:
$ xattr -cr /Applications/KeepGoing.app