Skip to content

CLI tool to persist and restore AI coding context across sessions, editors, and teams.

License

Notifications You must be signed in to change notification settings

AkashKobal/contextmemory

npm license

ContextMemory 🧠

Persistent AI coding context memory for developers and teams. Git tracks your code history. ContextMemory tracks your intent history. Never re-explain your architecture, decisions, or progress to AI assistants again.

You're deep in a Cursor session refactoring a payment service. You've explained the architecture, tried 3 approaches, finally found the right one. Session dies. Next morning — or worse, your teammate picks it up — and the AI has zero memory. You spend 15 min re-explaining everything. Every. Single. Time.

This is broken across every AI coding tool: Cursor, Claude Code, Copilot, Windsurf — none of them persist context across sessions, editors, or team members.


🚀 Installation

Install globally from npm:

npm install -g @akashkobal/contextmemory

Verify installation:

contextmemory --help

⚡ Quick Start

Initialize inside your project:

contextmemory init

Save your working context:

contextmemory save

Quick save:

contextmemory save "Implemented multi-model execution"

Resume your context:

contextmemory resume

This copies a formatted prompt to your clipboard.
Paste it into ChatGPT, Cursor, Claude, or any AI coding tool.


🧠 How It Works

ContextMemory creates:

.contextmemory/
├── context.json
├── history/
│   ├── entry-1.json
│   ├── entry-2.json

Each entry captures:

  • Task
  • Goal
  • Approaches
  • Decisions
  • Current State
  • Next Steps

📦 Commands

Core

contextmemory init
contextmemory save
contextmemory resume
contextmemory log
contextmemory diff

Automation

contextmemory watch
contextmemory hook install
contextmemory handoff @username

🔌 MCP Integration (Optional)

Add to your MCP configuration:

{
  "mcpServers": {
    "contextmemory": {
      "command": "npx",
      "args": ["-y", "@akashkobal/contextmemory", "mcp"]
    }
  }
}

🏗 Works With

  • Spring Boot
  • React
  • Node.js
  • Python
  • Microservices
  • Monorepos

AI Tools:

  • ChatGPT
  • Cursor
  • Claude
  • Copilot
  • Windsurf

📄 License

MIT


👨‍💻 Author

Akash Kobal
GitHub: https://github.com/AkashKobal