aimemory

AI Memory Extension for Cursor 🐹

Persistent, context-aware memory for AI workflows in Cursor and VS Code

Give your AI assistant a memory bank that remembers your project context, decisions, and progress across sessions. No more repeating yourself—your AI learns and grows with your project.

---

🚀 Quick Start

Installation

For Cursor Users:

1. Install the extension from Cursor marketplace (coming soon)
2. Open Command Palette (Cmd/Ctrl+Shift+P)
3. Run: AI Memory: Open Dashboard
4. Click "Initialize Memory Bank"

For Developers:

git clone https://github.com/sm-moshi/aimemory.git
cd aimemory
pnpm install && pnpm build
# Press F5 in Cursor/VS Code to launch extension

Basic Usage

# Chat commands in Cursor
/memory status              # Check memory bank health
/memory list               # See all stored memories
/memory read projectbrief  # Read specific memory file

---

✨ What It Does

• 🧠 Persistent Memory: Your AI remembers project context between sessions
• 📁 Organized Structure: Auto-creates folders for project briefs, technical context, and progress
• 🔄 Self-Healing: Automatically repairs missing or corrupted files
• 💬 Chat Integration: Use /memory commands directly in Cursor chat
• 🛡️ Secure: Input validation, path protection, no data sent to external services
• ⚙️ Set Log Level: Configurable logging from trace to error levels

---

📖 Memory Bank Structure

memory-bank/
├── core/                    # Essential project information
│   ├── projectBrief.md     # Project overview and goals
│   ├── productContext.md   # Product requirements and context
│   └── activeContext.md    # Current focus and priorities
├── progress/               # Project tracking and history
│   ├── index.md           # Progress overview
│   ├── current.md         # Current tasks and status
│   └── history.md         # Completed work history
├── systemPatterns/         # Architecture and design patterns
│   ├── index.md           # Pattern overview
│   ├── architecture.md    # System architecture
│   ├── patterns.md        # Design patterns used
│   └── scanning.md        # Code analysis patterns
└── techContext/           # Technical stack and environment
    ├── index.md          # Tech stack overview
    ├── stack.md          # Technology choices
    ├── dependencies.md   # Key dependencies
    └── environment.md    # Development environment

---

🛠️ Key Features

• Zero Configuration - Works out of the box
• STDIO MCP Server - Optimized for Cursor compatibility
• React Dashboard - Modern webview for memory management
• Efficient File Operations - Optimized for typical memory bank file sizes
• British English - Consistent language throughout

---

📚 Documentation

• Phase 4 Restructuring Plan - Current development progress
• Troubleshooting Guide - Common issues and solutions
• Contributing Guidelines - How to contribute

---

🤝 Contributing

We welcome contributions! Please:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes following our coding standards
4. Run tests: pnpm test
5. Submit a pull request

Requirements:

• British English throughout codebase
• Comprehensive test coverage
• Follow existing code patterns

---

📄 License & Support

License: Apache 2.0

Need Help?

• 🐛 Report Issues
• 💬 Ask Questions
• 📖 Read Documentation

---

Built with ❤️ for the Cursor and VS Code communities