KeepGoing
Resume projects after days or weeks away by showing what you were doing, what you planned next, and relevant context.
The Problem
When you step away from a project, for days, weeks, or longer, it's hard to remember:
- What you were doing
- What you planned to do next
- What files you were working in
KeepGoing saves lightweight session checkpoints that capture your context, so you can pick up where you left off with minimal mental effort.
Features
Session Checkpoints
Save what you did, what's next, and any blockers. Each checkpoint automatically captures your current git branch and touched files.
- Save Session Checkpoint - Record a detailed checkpoint with summary, next steps, and blockers
- Quick Checkpoint (
Cmd+Shift+K / Ctrl+Shift+K) - Save a checkpoint in one step
- Annotate Checkpoint - Add notes to an existing checkpoint
Auto-Checkpoints
KeepGoing can automatically save checkpoints so you never forget:
- On inactivity - Saves after 75 minutes of inactivity (configurable)
- On git commit - Captures context whenever you commit
- On branch switch - Saves before you switch to a different branch
Session Recall
When you return to a project, instantly see what you were working on:
- Show Last Session - View your last checkpoint in a modal
- View Full History - Browse all past checkpoints
- Open Touched Files - Reopen the files from your last session in one click
- Sidebar View - Always-visible summary in the activity bar
MCP Integration
KeepGoing includes an MCP (Model Context Protocol) server that lets AI coding assistants access your session checkpoints. This gives tools like Claude Code and GitHub Copilot awareness of what you were working on, so they can help you resume where you left off.
- Setup Claude Code - Registers the KeepGoing MCP server with Claude Code via the CLI
- Setup GitHub Copilot - Adds the KeepGoing MCP server to your project's
.vscode/mcp.json
Both commands install the MCP server via npx @keepgoingdev/mcp-server, so no global installation is needed.
Local-First
- All data stays in your workspace (
.keepgoing/ folder)
- No accounts, no cloud, no backend
- Human-readable JSON files you can inspect or version control
- Works offline, always
Data Storage
Session data is stored in a .keepgoing/ folder inside your workspace:
.keepgoing/
meta.json - Project identity (projectId, timestamps)
sessions.json - All session checkpoints
state.json - Last session state for quick access
By default, .keepgoing/ is automatically added to .gitignore. You can disable this in settings to share context with your team.
Commands
| Command |
Keybinding |
Description |
| KeepGoing: Save Session Checkpoint |
|
Prompts for summary, next step, and optional blocker |
| KeepGoing: Quick Checkpoint |
Cmd+Shift+K / Ctrl+Shift+K |
Save a checkpoint in one step |
| KeepGoing: Show Last Session |
|
View the last checkpoint in a modal |
| KeepGoing: View Full History |
|
Browse all past checkpoints |
| KeepGoing: Open Touched Files |
|
Reopen files from the last session |
| KeepGoing: Annotate Checkpoint |
|
Add notes to an existing checkpoint |
| KeepGoing: Setup Claude Code |
|
Install the KeepGoing MCP server for Claude Code |
| KeepGoing: Setup GitHub Copilot |
|
Install the KeepGoing MCP server for GitHub Copilot |
Settings
| Setting |
Default |
Description |
keepgoing.inactivityTimeoutMinutes |
75 |
Minutes of inactivity before an auto-checkpoint |
keepgoing.checkpointOnCommit |
true |
Auto-checkpoint on git commit |
keepgoing.checkpointOnBranchSwitch |
true |
Auto-checkpoint on branch switch |
keepgoing.enableWorkReminders |
false |
Show reminders to save checkpoints |
keepgoing.workReminderMinutes |
45 |
Minutes between work reminders |
keepgoing.addToGitignore |
true |
Auto-add .keepgoing/ to .gitignore |
Requirements
- Visual Studio Code v1.85.0 or later
Contributing
Found a bug or have a feature request? Open an issue on our community repo.
License
MIT
