🚀 gitprompt

Version AI workspace context alongside your code.

gitprompt is a 2026-standard CLI tool designed to solve the "Agent Memory Gap." It records what was built, what constraints were locked in, and what tools were used after each AI-assisted coding session—ensuring context survives project handoffs, branch switches, and model upgrades.

✨ Features

• 📂 Consolidated Context: Standardized .gitprompt/ directory for project memory.
• ⚡ Atomic Checkpoints: Use gitprompt cp to stage, commit, and record context in one atomic move.
• 📚 Docs Pipeline: Automatically fetch and summarize AI-optimized cheatsheets for your dependencies.
• 🎨 Interactive Explorer: A premium TUI dashboard to navigate your session history.
• 🤖 Framework First: Native integration for gstack, BMAD, and Superpowers.
• 🪄 Magic Diff Driver: Human-readable summaries with Critical Decision Delta highlighting for constraints.
• ⚡ Zero-Friction Onboarding: Get started in 10 seconds with gitprompt init --minimal.
• 💡 Actionable Error Hints: "Did-you-mean" style troubleshooting built into every command.

🛠️ Installation

npm install -g gitprompt
# or
pnpm add -g gitprompt

💡 Resuming a project after 3 weeks

Imagine cloning a project you haven't touched in a month. Instead of starting blind, you run:

$ git clone https://github.com/team/saas-app
$ gitprompt show step-12 --context --copy

Paste into Claude. The AI immediately knows:

• Next.js 15 App Router, Prisma, and Stripe are already configured.
• Auth is complete, but subscription billing logic is still in progress.
• Rules: "Never use getServerSideProps" and "Use session-only auth" are strictly enforced.

You are back to 100% productivity in 30 seconds.

🏁 Quick Start

1. Initialize your workspace

# Full interactive setup
gitprompt init

# Or lightning-fast (10s) setup
gitprompt init --minimal

This sets up your .gitprompt/ directory and pulls matching documentation blocks from the community registry.

2. Record a session

After finishing an AI task:

git commit -m "feat: implement auth"
gitprompt add -m "implemented jwt auth flow with prisma"

Or do it all in one go:

gitprompt cp -m "feat: implement auth"

3. Resume with full context

When you or a teammate return to the project:

gitprompt show step-1 --context --copy
# Paste the 100% accurate project context into your AI tool.

🕹️ Interactive Explorer

Launch the dashboard to browse history, search steps, and copy bundles:

gitprompt explore

📡 Documentation Pipeline

Keep your AI cheatsheets up to date with your actual installed versions:

gitprompt docs update

Pulls from Context7, llms.txt, and NPM to generate high-density summaries.

🌍 Community Registry

Explore high-quality, pre-built context blocks for popular stacks and MCPs:

gitprompt registry

Contributors are welcome! Visit github.com/gitprompt/registry to add your favorite frameworks and tools.

🤝 AI Workflow Integrations

gitprompt detection scripts automatically bridge the gap to other popular frameworks:

• BMAD: Automatically detects PRDs and architecture docs to pre-fill session intent.
• gstack: Injects capture skills for Claude Code.
• Superpowers: Standardizes IDE rules across Cursor and Windsurf.

📖 Commands

| Command | Alias | Description | |---|---|---| | init | i | Interactive workspace setup | | add | a | Record a session step | | checkpoint| cp| Stage + Commit + Record context | | explore | e | Open the interactive TUI | | registry | r | Browse community blocks & stacks | | log | l | Show session history | | show | s | Print/Copy context bundles | | docs update| u | Update documentation cheatsheets | | check | c | Verify workspace health | | export | ex| Generate IDE/Agent rules |

⚖️ License

MIT © 2026 Gitprompt Team