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
Avoids browser and Gatekeeper warnings entirely. Updates with brew upgrade. Share this with friends instead of the DMG link.
$ brew tap keepgoing-dev/tap
$ brew install --cask keepgoing
Direct download
The DMG is not yet Apple-signed, so browsers and macOS will show warnings on first install. Expect two small hoops below, then you are done. Prefer Homebrew above if you want to skip them.
Download DMGTip: click the button above. Pasting the link directly into the address bar may trigger a stricter browser block.
1. Your browser warns you on download
Chrome and Edge may say the file is "not commonly downloaded" or similar. Click Keep (Chrome) or Keep anyway (Edge). Safari and Firefox download without a warning.
2. macOS refuses to open the app
After dragging KeepGoing.app to Applications, macOS will block the first launch with "cannot be opened because Apple cannot check it for malicious software." Clear the quarantine flag once:
$ xattr -cr /Applications/KeepGoing.app
Prefer not to touch Terminal? Right-click the app in Applications and choose Open the first time. macOS 15 users may need System Settings > Privacy & Security > Open Anyway.
Apple code signing and notarization are on the roadmap. Once enabled, both warnings go away.