@keepgoing/cli

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

Install

# Run without installing
npx @keepgoing/cli status

# Install globally
npm install -g @keepgoing/cli

# Or add to a project
npm install --save-dev @keepgoing/cli

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)

Flags:

• --cwd <path> — override the working directory
• --json — output raw JSON of the last checkpoint (for scripting)
• --quiet — output a single summary line (used by the shell hook)

keepgoing save

Save a new checkpoint interactively. Prompts for:

1. What did you work on? (required)
2. What's your next step? (required)
3. Any blockers? (optional)

Git branch and touched files are auto-detected from the workspace.

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. Detected from $SHELL.

keepgoing hook install
# → Reload your shell:
source ~/.zshrc   # or ~/.bashrc

keepgoing hook uninstall

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

keepgoing hook uninstall

Shell Hook Setup

The shell hook gives you zero-friction project context when you enter a project directory.

After running keepgoing hook install and reloading your shell, entering any directory with a .keepgoing/ folder will automatically print:

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

Data Format

Reads and writes the same .keepgoing/ schema used by the VS Code extension:

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

Development

From the monorepo root:

npm run build --workspace=apps/cli