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

1

Checkpoints are saved by another tool

The VS Code extension, MCP server, or CLI writes session checkpoints to a .keepgoing/ folder in your project.

2

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.

3

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.

Terminal

$ brew tap keepgoing-dev/tap

$ brew install --cask keepgoing

Direct download

Download the DMG and drag to Applications.

Download DMG

Gatekeeper 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:
Terminal

$ xattr -cr /Applications/KeepGoing.app

100% Free and Local