@shaykec/extension

Chrome extension (Manifest V3) for Socrates -- adds web capture, context-aware learning suggestions, and real-time canvas companion functionality.

Three Roles

1. Canvas Companion

WebSocket connection to the bridge server for real-time bidirectional communication. The extension popup shows connection status, current lesson, and quick actions (Open Canvas, Dashboard, Pause).

2. "Teach Me This" (Web Capture)

• Highlight text on any webpage, right-click, select "Teach me this"
• Sends selected text + URL + context to the bridge server
• Claude Code creates an instant Socratic lesson on the highlighted content
• Also supports "Quiz me on this" for instant quiz generation

3. Context-Aware Suggestions

• Reads page title and meta tags (never full page content -- privacy-first)
• Matches against module trigger keywords locally (no AI calls)
• Shows a subtle notification when a matching module exists
• Dismiss suppresses the topic for 24 hours

Key Files

• manifest.json -- Permissions: activeTab, contextMenus, storage
• src/background.js -- WebSocket connection, message routing, context matching
• src/content.js -- Page metadata extraction, text selection, notification UI
• src/popup/ -- Extension popup (status, lesson info, quick actions)

Installation

1. Build: npm run build (no build step needed -- vanilla JS)
2. Open chrome://extensions/
3. Enable Developer Mode
4. Click "Load unpacked" and select the packages/extension/ directory

Dependencies

None -- vanilla JavaScript using Manifest V3 APIs.

See the root README for full documentation.