Your project context, right in the terminal

The KeepGoing CLI lets you check your last checkpoint, save new ones, and install a shell hook that shows your context every time you enter a project directory.

Running keepgoing status in your project:

Terminal

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)

Install

Run without installing:

Terminal 
npx @keepgoing/cli status

Install globally:

Terminal 
npm install -g @keepgoing/cli

Or add to a project:

Terminal 
npm install --save-dev @keepgoing/cli

Commands

keepgoing status

Show the last checkpoint for the current project. Prints the summary, next step, branch, and files touched.

Flag Description
--cwd <path> Override the working directory
--json Output raw JSON of the last checkpoint, useful for scripting
--quiet Output a single summary line (used by the shell hook)

keepgoing save

Save a new checkpoint interactively. Prompts for what you worked on, your next step, and any blockers. Git branch and touched files are auto-detected.

keepgoing hook install

Install a shell hook that runs keepgoing status --quiet automatically whenever you cd into a directory that contains .keepgoing/. Supports zsh and bash.

keepgoing hook uninstall

Remove the shell hook from your ~/.zshrc or ~/.bashrc.

Shell hook

Install the shell hook for zero-friction project context. Every time you cd into a directory with a .keepgoing/ folder, your last checkpoint is printed automatically.

Step 1: Install the hook

Terminal 
keepgoing hook install

Step 2: Reload your shell

Terminal 
source ~/.zshrc   # or ~/.bashrc

Now entering any project directory with .keepgoing/ shows:

Terminal

~ cd ~/projects/my-app

KeepGoing · 3 days ago · Refactored auth middleware to support JWT rotation

How it works

The CLI reads and writes the same .keepgoing/ schema used by the VS Code extension. You can use the CLI standalone or alongside the extension.

Checkpoint data is stored as local JSON files in your project directory. Nothing is sent to the cloud.

  • .keepgoing/sessions.json — all checkpoints
  • .keepgoing/state.json — last session state
  • .keepgoing/meta.json — project metadata

Pair with your AI tools

The CLI writes checkpoints that AI tools can read via the MCP server.

Claude Code

AI assistant that knows your project momentum

GitHub Copilot

Context-aware coding companion in your editor

Get started

Run your first status check in seconds.

Terminal 
npx @keepgoing/cli status