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.

The Problem

When working with AI coding tools like:

• ChatGPT
• Cursor
• Claude
• Copilot
• Windsurf

Context is lost between sessions.

You repeatedly explain:

• Architecture
• Decisions
• Current progress
• What you already tried

This reduces productivity.

The Solution

ContextMemory is a CLI tool that:

• Saves your coding context
• Restores it instantly
• Works across sessions, machines, and teams
• Works with any programming language

Spring Boot, React, Node, Python — all supported.

Installation

Install globally:

npm install -g contextmemory

Or install from source:

git clone https://github.com/AkashKobal/contextmemory.git
cd contextmemory
npm install
npm run build
npm link

Quick Start

Initialize in your project:

contextmemory init

Save your context:

contextmemory save

Quick save:

contextmemory save "Implemented multi-model execution"

Resume context:

contextmemory resume

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

Example Workflow

Start work:

contextmemory resume

Work normally on your code.

End work:

contextmemory save "Added parallel execution using CompletableFuture"

Next day:

contextmemory resume

Continue immediately.

Project Structure

ContextMemory creates:

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

Stores:

• Task
• Goal
• Decisions
• Approaches
• Current state
• Next steps

Commands

Core Commands

Initialize:

contextmemory init

Save context:

contextmemory save

Quick save:

contextmemory save "message"

Resume context:

contextmemory resume

View history:

contextmemory log

Show git diff summary:

contextmemory diff

Automation Commands

Auto-save on file changes:

contextmemory watch

Install git hook:

contextmemory hook install

Team handoff:

contextmemory handoff @username

Example: Spring Boot Project

Initialize:

contextmemory init

After implementing services:

contextmemory save "Implemented ModelRouterService and model integrations"

Next day:

contextmemory resume

AI understands your architecture instantly.

MCP Integration (Optional)

Add to your MCP configuration:

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

Exposes tools:

• contextmemory_save
• contextmemory_resume
• contextmemory_log

Supported Environments

Works with:

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

Works with AI tools:

• ChatGPT
• Cursor
• Claude
• Copilot
• Windsurf

License

MIT License

Author

Akash Kobal

GitHub:
https://github.com/AkashKobal/contextmemory

Contributing

Pull requests are welcome.

Roadmap

• Cloud sync
• Team dashboards
• VS Code extension
• Enterprise edition