@keepgoingdev/cli

Terminal CLI for KeepGoing - resume side projects without the mental friction.

Install

# One-line install (recommended)
curl -fsSL https://keepgoing.dev/install.sh | bash

# Or install with npm directly
npm install -g @keepgoingdev/cli

Setup

Run the interactive wizard once per device:

keepgoing setup

This configures KeepGoing for your AI tools (Claude Code, Copilot, Cursor, Windsurf), IDE, and shell. Use a preset to skip straight to a tool:

keepgoing setup claude       # pre-select Claude Code
keepgoing setup copilot      # pre-select GitHub Copilot
keepgoing setup cursor       # pre-select Cursor

On subsequent projects, replay your saved profile without prompts:

keepgoing init

Commands

keepgoing status

Show the last checkpoint for the current project.

KeepGoing · 12 days ago

  Summary:   Refactored auth middleware to support JWT rotation
  Next step: Implement verifyRefreshToken helper in auth.ts
  Branch:    feature/auth-refactor
  Files:     auth.ts, middleware.ts, routes/token.ts (+2 more)

keepgoing save

Save a checkpoint. Auto-generates the summary and next step from recent git activity.

keepgoing save                         # auto-generate from git
keepgoing save -m "Finished auth flow" # custom summary
keepgoing save -n "Write tests next"   # custom next step
keepgoing save --force                 # save even if no recent changes

keepgoing briefing

Get a re-entry briefing when coming back to a project.

keepgoing briefing
keepgoing briefing --tier detailed     # more context (compact, standard, detailed, full)
keepgoing briefing --model claude-opus-4  # auto-select tier from model name

keepgoing momentum

Show current developer momentum - what you're focused on and how active the project is.

keepgoing log

Browse session checkpoints with rich filtering.

keepgoing log --today
keepgoing log --week --oneline
keepgoing log --follow src/auth.ts     # checkpoints that touched this file
keepgoing log --search "auth"          # search summaries
keepgoing log --sessions               # group by session
keepgoing log decisions                # browse decision records (Pro)

keepgoing glance

Single-line context snapshot for shell prompts and status bars. Completes in <50ms.

keepgoing hot

Cross-project activity summary sorted by momentum (hot projects first).

keepgoing continue

Export context to use in another AI tool (ChatGPT, Gemini, Copilot, etc.).

keepgoing continue --target chatgpt --open

keepgoing decisions

View decision history. Pro feature.

keepgoing decisions --branch feature/auth --limit 20

keepgoing hook install

Install a shell hook that shows a quick status line when you cd into a KeepGoing project.

keepgoing hook install
source ~/.zshrc   # reload shell

Supports zsh, bash, and fish.

keepgoing doctor

Check storage health, detect orphaned sessions, and run integrity checks.

keepgoing migrate

Migrate legacy JSON storage to SQLite (one-time, for projects that used older versions).

keepgoing activate <key>

Activate a Pro license on this device.

keepgoing update

Update the CLI to the latest version.

Shell Hook

After keepgoing hook install and reloading your shell, entering any directory with .keepgoing/ prints a quick status line automatically - no manual command needed.

Data Storage

Per-project data lives in .keepgoing/keepgoing.db (SQLite, auto-created). Global data (license, tray config) lives in ~/.keepgoing/. The .keepgoing/ directory is automatically added to .gitignore.

Development

See CLAUDE.md for architecture details. From the monorepo root:

npm run shared:build && npm run cli:build
npm run cli:test