AI Project Memory

AI Project Memory is a production-grade VS Code extension designed to help developers instantly recall project context and codebase details when returning to a repository after days, weeks, or months.

🌟 Features

• 🧠 Memory Snapshots: Traverses and maps the local workspace structure to create a structured and indexed snapshot of the project.
• 🕒 Chronological Timeline: Groups Git commits, session tracking history, and modified files into intuitive time buckets (today, this week, last month) within a sidebar view.
• 🗺️ Architecture Visualization: Renders interactive Mermaid.js dependency graphs and folder subgraphs directly inside VS Code to help you visualize system design.
• 💬 AI Project Chat: Converse with an AI that knows your workspace. Ask questions like:
  • "What does this project do?"
  • "Where is the payment integration?"
  • "What was I working on yesterday?"
• 📁 Git Intelligence: Summarizes branch statuses, uncommitted changes/diffs, and commit histories.
• 🔒 Secure API Key Storage: Integrates with VS Code's native SecretStorage to encrypt and store LLM credentials securely.
• ⚡ Parallel Processing & Low Overhead: Scans directories recursively using concurrency limits and ignores binary files and common built folders (e.g. node_modules, dist, .next).

🚀 Getting Started

1. Install the Extension from the marketplace.
2. Configure Your API Key Securely:
   • Run the command AI Project Memory: Set API Key Securely via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P).
   • Select your provider (e.g., OpenAI) and input your API key. This stores the key securely using VS Code's encrypted SecretStorage container instead of cleartext settings files.
3. Select Your Model: Open Settings (Ctrl+,) and configure the model (e.g., gpt-4o-mini).
4. Generate Memory: Click the Brain icon on the editor title bar, or run AI Project Memory: Generate Memory from the Command Palette.

⚙️ Extension Settings

This extension contributes the following settings:

⌨️ Command Registry

You can run the following commands from the Command Palette:

• AI Project Memory: Generate Memory: Scans the project, invokes the AI summary engine, and updates the sidebar layout.
• AI Project Memory: Show Memory: Opens the sidebar snapshot view showing the active timeline and scanned files.
• AI Project Memory: Set API Key Securely: Stores an API key securely in VS Code's encrypted SecretStorage.
• AI Project Memory: Show Architecture Visualization: Generates and renders the interactive Mermaid.js diagram.
• AI Project Memory: Open Settings: Launches settings specifically filtered to the AI Project Memory category.
• AI Project Memory: Clear Memory: Permanently deletes all generated snapshots and deletes .project-memory/memory.json from the disk.

🛠️ Development

1. Clone the repository.
2. Run npm install to load dependencies.
3. Start the compiler in watch mode: npm run watch.
4. Press F5 in VS Code to run the extension in an Extension Development Host environment.

📄 License

This extension is licensed under the MIT License.