🧠 ThoughtGit

Semantic Version Control for Human Thinking
Track, visualize, and optimize developer learning, cognitive evolution, and memory stability in real time.

📖 Overview

Standard Git excels at tracking lines of code that change over time. However, the developer's mental state, design intent, and conceptual learning paths are completely lost.

ThoughtGit bridges this gap. It provides a branch-aware cognitive version control system right inside VS Code. It indexes your thoughts, tags codebase topics, tracks concept drift over time, and schedules review reminders based on human memory decay curve algorithms—complete with a beautiful roadmap visualizer.

⚡ Key Features

🗺️ Interactive Codebase Roadmap

• Complete Directory Mapping: Scans your entire project folder hierarchy (ignoring package files like node_modules or venv) and displays it in a clean, professional vertical timeline roadmap.
• Automated Human Explanations: Automatically parses file docstrings, module headers, and comments to display simple, natural-language summaries of what each file does.
• Editor Integration: Click any file card inside the roadmap to open a detailed slide-out side panel, and click ⚡ Open File in Editor to jump straight to the source code.

🌿 Branch-Aware Vector Storage

• Your thoughts are isolated by workspace and git branch (e.g. main vs feature/auth), preventing thoughts from overlapping across projects.
• The Evolution View displays the chronological shift in your understanding of specific concepts, calculating semantic similarity drift metrics automatically.

🧬 Spaced Repetition Spacing Scheduler

• Uses a Forgetting Curve Estimation Model ($R = e^{-t/S}$) to compute your current memory retention strength for saved topics.
• Alerts you via the UI when your retention of a topic drops below 40%, keeping your codebase knowledge stable and refreshed.
• Provides a Memory Health Report showingSpacing frequency, topic diversity, and active logging logs.

🚀 Quick Start

Step 1: Pull the Embedding Model

ThoughtGit runs a local semantic vector search engine on your machine. Install Ollama and run the embedding model:

ollama pull nomic-embed-text

Step 2: Install the Extension

1. Search for ThoughtGit in the VS Code Extensions View (Ctrl+Shift+X) and click Install.
2. Click the Brain Icon 🧠 in your VS Code Activity Bar on the left.
3. Open any workspace folder. The extension will automatically set up the local Python backend in the background.
4. Click Open Project Visualizer to open your dashboard.

🎹 Contributed Commands

You can trigger the following commands via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P on macOS):

📦 Building and Packaging the VSIX

To package and download the extension VSIX file directly:

1. Open your terminal inside the vscode-extension directory.
2. Install npm dependencies:

   npm install
   

3. Compile the TypeScript codebase:

   npm run compile
   

4. Package the VSIX container using VSCE (VS Code Extension Manager):

   npx @vscode/vsce package --allow-missing-repository
   

5. Install the generated .vsix file:
   • Open the Extensions View (Ctrl+Shift+X).
   • Click the top-right ... (More Actions) menu.
   • Select Install from VSIX... and choose the thoughtgit-0.1.5.vsix file.

📅 Changelog

v0.1.5 (Latest Release)

• NEW: Replaced browser confirm() popups with Native VS Code Warning Dialogs (showWarningMessage) for deletion confirmation (fixing deletion lockups inside sidebar webviews).
• NEW: Added a 🔗 Ping Website in Background feature to run background GET requests and load external roadmap links without launching browser windows.
• NEW: Detailed VSIX building, packaging, and installation manual written directly into the README.md.

v0.1.4

• NEW: Replaced the codebase import flowchart with a stunning, vertical Interactive Codebase Roadmap (inspired by roadmap.sh), mapping all directories, subfolders, and files.
• NEW: Implemented Thought Deletion (🗑️) in the sidebar card list, letting you remove mistakenly added thoughts from ChromaDB instantly.
• IMPROVED: Copied complete detail documents into the packaged VSIX package for correct VS Code Marketplace representation.
• OPTIMIZED: Lightweight bundling drops extension package size from 859 MB down to 175 KB by ignoring local venv folders during compilation.
• FIXED: Removed Unicode character checkmarks that crashed command shells in CP1252 Windows environments.
• FIXED: Dynamic database collection isolation based on Workspace Directory context headers (X-Workspace-Dir).

v0.1.0 (Initial Release)

• Core: Initial release of branch-aware cognitive memory vector storage.
• Integration: Local embeddings indexing via Ollama nomic-embed-text.
• Dashboard: Force-directed D3 concept map and time-slider chronological playback.