Skip to content

README.md

Latest commit

 

History

History
98 lines (68 loc) · 4.07 KB

README.md

File metadata and controls

98 lines (68 loc) · 4.07 KB

@keepgoingdev/mcp-server

MCP server for KeepGoing.dev - a momentum companion for developers. KeepGoing helps you keep going on projects when you return after time away.

KeepGoing auto-captures checkpoints (what you were doing, what's next, which files matter) on git commits, branch switches, and inactivity. When you start a new session, your AI assistant reads your last checkpoint instead of re-inferring everything from scratch. Local-first, no account required.

Quick Setup

The easiest way to get started is with the installer, which installs the CLI globally and runs the setup wizard:

curl -fsSL https://keepgoing.dev/install.sh | bash

For a specific tool:

curl -fsSL https://keepgoing.dev/install.sh | bash -s -- claude
curl -fsSL https://keepgoing.dev/install.sh | bash -s -- vscode

Claude Code (manual)

Global (recommended) — works across all your projects:

claude mcp add keepgoing --scope user -- npx -y @keepgoingdev/mcp-server

Per-project — scoped to a single project:

claude mcp add keepgoing --scope project -- npx -y @keepgoingdev/mcp-server

Then run keepgoing setup claude to configure hooks and rules.

Cursor, Windsurf, and other tools

Add to your MCP config file (~/.cursor/mcp.json for Cursor, or the equivalent for your tool):

{
  "mcpServers": {
    "keepgoing": {
      "command": "npx",
      "args": ["-y", "@keepgoingdev/mcp-server"]
    }
  }
}

Tools

Core

Tool Description
get_momentum Get your last checkpoint, next step, blockers, and branch context. Quick snapshot of where you left off. Accepts optional tier and model params for token-aware output.
get_reentry_briefing Get a synthesized re-entry briefing with focus, recent activity, and suggested next steps. Accepts optional tier and model params for token-aware briefing tiers.
get_session_history Get recent session checkpoints in chronological order. Supports branch filtering and configurable limit.
get_whats_hot See recently active files and branches across sessions.
continue_on Export your development context as a formatted prompt for another AI tool (chatgpt, gemini, copilot, claude, general).
save_checkpoint Save a development checkpoint after completing a task or meaningful piece of work.

Paid Add-ons

Tool Add-on Description
get_decisions Decision Detection Get recent high-signal commits with their category, confidence, and rationale.
get_current_task Session Awareness Get current live session tasks across multiple concurrent AI agent sessions.
activate_license Activate a KeepGoing license on this device.
deactivate_license Deactivate the KeepGoing license on this device.

How It Works

  1. Add this MCP server to your AI coding assistant (Claude Code, Cursor, Windsurf, etc.)
  2. Start coding. Use save_checkpoint from your AI assistant to capture what you did, what's next, and any blockers
  3. Come back anytime. Your AI assistant calls get_momentum or get_reentry_briefing to pick up exactly where you left off
  4. Optionally, install the KeepGoing VS Code extension for automatic checkpoint capture on inactivity, git commits, and branch switches — no manual saves needed

All data is stored locally in a .keepgoing/ directory at your git root.

Requirements

  • Node.js 18+
  • The KeepGoing VS Code extension is optional — useful for auto-capturing checkpoints on git commits, branch switches, and inactivity, but the MCP server works standalone via save_checkpoint

Links

License

MIT