Tab Memory

Local-first tab capture system for Chrome/Firefox that stores URLs, scrapes pages, summarizes with Gemini, and supports fast later retrieval.

What is here

• API contract: openapi/collector-api.openapi.yaml
• Database migrations: db/migrations/
• Collector server: server/
• Browser extension: extension/
• Project docs: docs/

Key UX workflows

• Single-tab hotkey capture + immediate intent micro-prompt
• Batch triage mode for multi-window tab sweeps
• Saved Queue UI for review/edit/retry/archive
• Smart auto-grouping of similar/duplicate tabs
• Retrieval-first exports by intent, project, session, or group

Quick start

1. Configure environment:

cd /Users/o2satz/tab-memory-spec/server
cp .env.example .env
# set GEMINI_API_KEY in .env

2. Start the collector:

cd /Users/o2satz/tab-memory-spec/server
npm install
npm run migrate
npm start

3. Check health:

BASE_URL="http://127.0.0.1:7821"
curl -sS "$BASE_URL/health"

4. Load extension from extension/.
5. Capture:

• Single tab: Command+Alt+S / Ctrl+Alt+S
• Triage mode: Command+Alt+G / Ctrl+Alt+G

6. Open queue UI:

http://127.0.0.1:7821/queue

Documentation index

• Docs index: docs/README.md
• Getting started: docs/GETTING_STARTED.md
• Architecture: docs/ARCHITECTURE.md
• API reference: docs/API_REFERENCE.md
• Troubleshooting: docs/TROUBLESHOOTING.md
• Implementation status: docs/IMPLEMENTATION_STATUS.md
• Extension guide: extension/README.md