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.

---

🚀 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