ReEntry

Never lose your place again.

ReEntry is a VS Code extension that generates a 3-sentence plain-English re-entry brief when you return to a project after a break. It tells you what you were working on, where you stopped, and what to do next — in under 10 seconds.

No setup. No API keys. No data leaves your machine. Ever.

✨ How It Works

When you open a workspace after 30+ minutes away, ReEntry automatically shows a brief panel beside your editor:

"You were tracking down a bug in the authentication layer on branch fix/auth-race, with 2 file(s) modified. You stopped at line 84 of refreshToken.ts after 54 minutes of active work. Open refreshToken.ts at line 84, re-read the function context, then finish the fix."

Read it. Start coding. That's it.

What Happens Behind the Scenes

1. Session Tracking — While you code, ReEntry silently tracks focus time, edit counts, save counts, cursor positions, and dirty state per file.
2. Gap Detection — When you reopen VS Code after a break, ReEntry measures the gap and decides whether a brief is needed.
3. 5-Engine Intelligence Pipeline — Signal Scorer → Intent Classifier → Area Extractor → Gap Interpreter → Brief Writer produce a context-aware, 3-sentence brief.
4. Adaptive Templates — 100 template variants (25 + 12 + 63) across 7 work intents and 3 urgency levels. Templates that receive positive feedback are selected more often over time.

⌨️ Keyboard Shortcuts

Instantly access any feature with a single shortcut:

Tip: These shortcuts work from anywhere in the editor — no need to open the command palette first.

📋 Commands

Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and type ReEntry:

🔐 Privacy — What Is and Is Not Collected

What leaves your machine: nothing. Zero network calls. No API. No LLM. No Ollama. No telemetry. Works fully offline. All data lives in .reentry/reentry.db inside your workspace — gitignored by default.

⚙️ Settings

🎯 Features

• Auto Brief on Return — Automatically shows a 3-sentence brief when you return after 30+ minutes
• Keystroke Dismiss — Brief panel auto-closes when you start typing — zero friction
• 90-Second Auto Dismiss — Panel closes itself if you don't interact
• File Navigation — Click any file pill in the brief to jump directly to the line you were on
• Helpful / Not Helpful Feedback — Rate briefs to improve template selection over time
• Rich Insights Dashboard — Productivity score ring, activity bars, commit streak tracking
• History View — Browse past briefs with gap durations and feedback ratings
• Cross-Platform — Works on Windows, macOS (Intel + Apple Silicon), and Linux
• Fully Offline — Zero network calls, no API keys, no accounts needed

🏗️ Architecture

ReEntry runs entirely locally as a VS Code extension with no backend:

┌─────────────┐   ┌──────────────┐   ┌───────────────┐
│  Session     │──▶│  Context     │──▶│  Brief        │
│  Tracker     │   │  Builder     │   │  Engine       │
│              │   │  (5 engines) │   │  (100 templates)│
└──────┬───────┘   └──────────────┘   └───────┬───────┘
       │                                       │
       ▼                                       ▼
┌──────────────┐                      ┌───────────────┐
│  SQLite DB   │                      │  Brief Panel  │
│  (sql.js/WASM)│                     │  (webview)    │
└──────────────┘                      └───────────────┘

5 Intelligence Engines:

1. Signal Scorer — Ranks files by importance (focus time, saves, edits, dirty state)
2. Intent Classifier — Detects work type from branch name and file paths (bug fix, feature, refactor, testing, config, docs)
3. Area Extractor — Maps file paths to human-readable areas (authentication, API layer, database, etc.)
4. Gap Interpreter — Converts time gaps into urgency levels and natural language labels
5. Brief Writer — Weighted template selection with adaptive learning from feedback

🔧 Requirements

• VS Code 1.85 or later
• Nothing else — no API keys, no accounts, no internet

📦 Installation

From VSIX File

1. Download reentry-0.1.1.vsix
2. Open VS Code → Extensions sidebar → ⋯ menu → Install from VSIX...
3. Select the downloaded file → Restart VS Code

Or via terminal:

code --install-extension reentry-0.1.1.vsix

From Source

git clone https://github.com/saranraj1/Context-Clock.git
cd Context-Clock
npm install
npm run compile
# Press F5 to launch Extension Development Host

🗒️ Release Notes

0.1.1 — Bug Fixes & Cross-Platform Support

• Migrated to sql.js (WebAssembly) — Works on all platforms without native compilation issues
• Fixed keystroke dismiss — Brief panel now closes when you start typing in the editor
• Fixed session gap display — Accurate gap duration shown for active sessions
• Fixed uncommitted streak metric — More accurate commit status detection
• Performance optimized — Eliminated N+1 database queries, added transaction batching
• VSIX size reduced — From 19.7 MB to 4.5 MB (77% smaller)

0.1.0 — Initial Release

• 3-sentence re-entry briefs with 5-engine intelligence pipeline
• 100 template variants across 7 work intents × 3 urgency levels
• Adaptive template weighting via feedback loop
• Session tracking (focus time, edits, saves, cursor, dirty state)
• Git integration (branch, commit hash, commit message)
• Privacy-first: SHA-256 workspace IDs, relative paths only, zero network calls
• Brief panel with auto-dismiss (90s), keystroke dismiss, file navigation
• History panel with 20 most recent briefs
• Insights dashboard with 5 coding metrics
• 5 commands + keyboard shortcuts (Alt+1/2/3) + 5 configurable settings

📄 License

MIT — Built by Precision Pros · Chennai, India · 2026