Your Project Context in the Starship Prompt
Add one module to your starship.toml and your prompt shows what you are working on, where you left off, and what to do next. Every project, automatically.
# ~/.config/starship.toml
[custom.keepgoing]
command = "keepgoing glance"
when = "test -d .keepgoing"
format = "[$output]($style) "
style = "dimmed cyan"
# Your prompt will look like:
~/code/my-project ⚡ Working on auth refactor → write tests (2h ago)
❯
Why add context to your prompt
The fastest context switch is the one you never have to make.
See context at a glance
Your prompt shows your project momentum, last summary, and next step without running any command. It is just there.
Only shows where it matters
The `.keepgoing` directory check keeps your prompt clean everywhere else. No output, no CLI call, no clutter in uninitialized directories.
Plugs into your existing Starship config
Adds one custom module block to your starship.toml. Works alongside your existing prompt modules without any conflicts.
Sub-50ms performance
The glance command reads only from `.keepgoing/` JSON files. No git calls, no network. Safe for every prompt render.
How it works
Install the KeepGoing CLI
Run the one-line installer: curl -fsSL https://keepgoing.dev/install.sh | bash. Or install directly with npm install -g @keepgoingdev/cli. Then run keepgoing init in your project.
Add the custom module to starship.toml
Add the [custom.keepgoing] block to ~/.config/starship.toml. The when condition ensures output only appears inside KeepGoing-initialized projects.
Open a new terminal
cd into any initialized project and your prompt will show the glance output. The momentum icon, summary, and next step are right there.
What changes with prompt context
Without KeepGoing
You switch into a project directory and have to recall what you were doing. You run git log or check comments to piece it together.
With KeepGoing
Your prompt already shows the momentum icon, summary, and next step from your last checkpoint. No commands needed.
Without KeepGoing
Your prompt clutters up in directories that have nothing to do with KeepGoing projects.
With KeepGoing
The `.keepgoing` guard means context only appears where it exists. Every other directory stays clean.
Without KeepGoing
You need a separate command, terminal tab, or sidebar to check project context.
With KeepGoing
Context is part of your prompt. It updates automatically on every render, zero keystrokes.
Frequently asked questions
Will this slow down my prompt?
No. The glance command reads only from .keepgoing/ JSON files, making no git calls or network requests. It consistently completes in under 50ms, which is well within safe limits for prompt commands.
Do I need Starship already installed?
Yes. This is a Starship custom module, so you need Starship set up first. Visit starship.rs for installation instructions, then add the KeepGoing module to your starship.toml.
What do the momentum icons mean?
⚡ Hot means an active session with recent activity.
🔶 Warm means a session exists but some time has passed.
💤 Cold means no recent activity.
If there is a blocker, it appears at the end of the line.
Can I change the style?
Yes. Use any Starship style string in the style field, such as "bold cyan" or "fg:green". The glance output is plain text, so any Starship style works.
Do I need the VS Code extension?
No. The CLI and this integration are fully editor-agnostic. Any tool that writes to .keepgoing/ works, including the CLI itself with keepgoing save.
What if I prefer not to use Starship?
See the shell prompt integration for Bash, Zsh, and Fish setups using built-in shell hooks. Or the tmux integration to show context in your status bar instead.
Works great with
Combine integrations for the best experience. Each tool reads from the same local data.
VS Code
Passive context capture in VS Code. A ContextSnapshot appears in the status bar on every branch, and the sidebar shows your full re-entry briefing when you return.
Learn moreClaude Code
Give Claude Code session continuity across conversations. The MCP server feeds your momentum, recent progress, and next steps directly into every session.
Learn moreGitHub Copilot
Connect KeepGoing to GitHub Copilot via MCP. Copilot gains access to your project momentum, session history, and suggested next steps.
Learn moreJetBrains
Re-entry briefings when you open a project after days away. Works with IntelliJ IDEA, WebStorm, PyCharm, and all JetBrains IDEs.
Learn moreCursor
AI-first editor with built-in Copilot. Connect KeepGoing via MCP so Cursor maintains session continuity, knows your next step, and respects recent decisions.
Learn moreWindsurf
Windsurf (by Codeium) AI coding editor. Connect KeepGoing via MCP so Cascade maintains session continuity and knows your next steps.
Learn moreCLI
Run keepgoing glance for instant context in under 50ms. Integrates with Starship and tmux. Shell hook fires on cd so context is always there.
Learn moreDesktop Tray
Glance across every project: what's hot, what's warm, what's cold. Global hotkey pulls up your full briefing from anywhere, no editor needed.
Learn moretmux
Show your KeepGoing context in the tmux status bar. Single project or multi-project view, refreshed automatically.
Learn moreShell Prompt
Embed KeepGoing context directly in your Bash, Zsh, or Fish prompt using built-in shell hooks. No extra tools required.
Learn moreSet it up in two minutes
Install the CLI, add the module, open a new terminal.