diff --git a/docs/VIEWER.md b/docs/VIEWER.md
deleted file mode 100644
index 182810b1..00000000
--- a/docs/VIEWER.md
+++ /dev/null
@@ -1,405 +0,0 @@
-# Viewer UI - Web-Based Memory Stream Visualization
-
-## Overview
-
-The Claude-Mem Viewer UI is a production-ready web interface that provides real-time visualization of your memory stream. Access it at **http://localhost:37777** while the claude-mem worker is running.
-
-**Key Features:**
-- 🔴 **Real-time Updates** - Server-Sent Events (SSE) stream new observations, sessions, and prompts instantly
-- 📜 **Infinite Scroll** - Load historical data progressively with automatic pagination
-- 🎯 **Project Filtering** - Focus on specific codebases with smart project selection
-- 🎨 **Theme Toggle** - Light, dark, or system preference with persistent settings
-- 💾 **Settings Persistence** - Sidebar state and project filters saved automatically
-- 🔄 **Auto-Reconnection** - Exponential backoff ensures connection stability
-- ⚡ **GPU Acceleration** - Smooth animations and transitions
-
-## Architecture
-
-### Technology Stack
-
-| Component | Technology | Purpose |
-|-----------|-----------|---------|
-| **Framework** | React + TypeScript | Component-based UI with type safety |
-| **Build System** | esbuild | Self-contained HTML bundle (no separate assets) |
-| **Real-time** | Server-Sent Events (SSE) | Push-based updates from worker service |
-| **State Management** | React hooks | Local state with custom hooks for SSE, pagination, settings |
-| **Styling** | Inline CSS | No external stylesheets, fully self-contained |
-| **Typography** | Monaspace Radon | Embedded monospace font for code aesthetics |
-
-### File Structure
-
-```
-src/ui/viewer/
-├── App.tsx # Main application component
-├── types.ts # TypeScript interfaces
-├── components/
-│ ├── Header.tsx # Top navigation with logo and theme toggle
-│ ├── Sidebar.tsx # Project filter and stats sidebar
-│ ├── Feed.tsx # Main feed with infinite scroll
-│ ├── ThemeToggle.tsx # Light/dark/system theme selector
-│ └── cards/
-│ ├── ObservationCard.tsx # Displays individual observations
-│ ├── SummaryCard.tsx # Displays session summaries
-│ ├── PromptCard.tsx # Displays user prompts
-│ └── SkeletonCard.tsx # Loading placeholder
-├── hooks/
-│ ├── useSSE.ts # Server-Sent Events connection
-│ ├── usePagination.ts # Infinite scroll logic
-│ ├── useSettings.ts # Settings persistence
-│ ├── useStats.ts # Database statistics
-│ └── useTheme.ts # Theme management
-└── utils/
- ├── constants.ts # Configuration constants
- ├── data.ts # Data merging and deduplication
- └── formatters.ts # Date/time formatting helpers
-```
-
-### Data Flow
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│ Worker Service (port 37777) │
-│ - Express HTTP API │
-│ - SSE endpoint: /stream │
-│ - REST endpoints: /api/* │
-└─────────────────────────────────────────────────────────────┘
- ↓
-┌─────────────────────────────────────────────────────────────┐
-│ Viewer UI (React App) │
-│ - useSSE hook: Real-time stream │
-│ - usePagination hook: Historical data │
-│ - useSettings hook: Persistent preferences │
-└─────────────────────────────────────────────────────────────┘
- ↓
-┌─────────────────────────────────────────────────────────────┐
-│ Feed Component │
-│ - Merges real-time + paginated data │
-│ - Deduplicates by ID │
-│ - Filters by selected project │
-│ - Infinite scroll triggers pagination │
-└─────────────────────────────────────────────────────────────┘
-```
-
-## Features In Detail
-
-### Real-Time Updates (SSE)
-
-The viewer uses Server-Sent Events to receive updates instantly:
-
-```typescript
-// SSE message format
-{
- "type": "observation" | "summary" | "prompt" | "projects" | "processing",
- "data": { /* record data */ }
-}
-```
-
-**Event Types:**
-- `observation` - New observation created
-- `summary` - Session summary generated
-- `prompt` - User prompt captured
-- `projects` - Project list updated
-- `processing` - Session processing status changed
-
-**Connection Management:**
-- Auto-reconnect on disconnect with exponential backoff
-- Visual connection status indicator in header
-- Graceful degradation if SSE unavailable
-
-### Infinite Scroll Pagination
-
-The feed loads historical data progressively:
-
-1. **Initial Load**: First 20 records loaded on mount
-2. **Scroll Trigger**: When user scrolls to 80% of feed height
-3. **Batch Load**: Next 20 records fetched via `/api/{type}?offset=X&limit=20`
-4. **Deduplication**: Merges with real-time data, removes duplicates by ID
-5. **Loading State**: Skeleton cards show while fetching
-
-**Performance:**
-- Requests debounced to prevent spam
-- Only visible when scrolled near bottom
-- Continues until no more records available
-
-### Project Filtering
-
-Filter memory stream by specific projects:
-
-1. Projects extracted from observations, summaries, and prompts
-2. Sidebar shows all unique project names with counts
-3. Click project name to filter feed
-4. Click "All Projects" to clear filter
-5. Filter persisted to localStorage
-
-**Project Detection:**
-- Extracted from `projectPath` or `project` field in records
-- Basename of path used as project name
-- Empty/null projects shown as "(No Project)"
-
-### Theme Toggle (v5.1.2)
-
-Three theme modes available:
-
-- **Light Mode**: Clean white background, dark text
-- **Dark Mode**: Dark background, light text (default)
-- **System**: Matches OS preference automatically
-
-**Implementation:**
-```typescript
-// Theme preference stored in localStorage
-localStorage.setItem('theme-preference', 'light' | 'dark' | 'system');
-
-// CSS variables updated dynamically
-document.documentElement.setAttribute('data-theme', resolvedTheme);
-```
-
-**CSS Variables:**
-```css
-:root[data-theme="light"] {
- --bg-primary: #ffffff;
- --text-primary: #1f2937;
- /* ... */
-}
-
-:root[data-theme="dark"] {
- --bg-primary: #111827;
- --text-primary: #f9fafb;
- /* ... */
-}
-```
-
-### Settings Persistence
-
-Settings automatically saved to worker service:
-
-**Saved Settings:**
-- `sidebarOpen` - Sidebar expanded/collapsed state
-- `selectedProject` - Current project filter
-- `theme` - Theme preference (light/dark/system)
-
-**API Endpoints:**
-- `GET /api/settings` - Retrieve saved settings
-- `POST /api/settings` - Save settings (debounced 500ms)
-
-**Local Fallback:**
-- If API unavailable, settings stored in localStorage
-- Synced back to API when connection restored
-
-## Usage Guide
-
-### Opening the Viewer
-
-1. Ensure claude-mem worker is running (auto-starts with Claude Code)
-2. Open browser to http://localhost:37777
-3. Viewer loads automatically with recent records
-
-### Navigating the Feed
-
-**Cards Displayed:**
-- **Observation Cards** (blue accent) - Tool usage observations with title, narrative, concepts, files
-- **Summary Cards** (green accent) - Session summaries with request, completion, learnings
-- **Prompt Cards** (purple accent) - Raw user prompts with timestamp and project
-
-**Card Features:**
-- Click to expand/collapse full details
-- Type indicators (🔴 bugfix, 🟣 feature, 🔄 refactor, etc.)
-- Concept tags (clickable for future filtering)
-- File references with paths
-- Timestamps in relative format ("2 hours ago")
-
-### Using Project Filters
-
-1. **Open Sidebar**: Click hamburger menu (☰) in top-left
-2. **View Stats**: See total observations, sessions, prompts
-3. **Select Project**: Click project name to filter
-4. **View Counts**: Numbers show records per project
-5. **Clear Filter**: Click "All Projects" to reset
-
-### Changing Theme
-
-1. **Open Theme Toggle**: Click theme icon in header
-2. **Select Mode**:
- - ☀️ Light mode
- - 🌙 Dark mode
- - 💻 System (follows OS)
-3. **Auto-Save**: Preference saved immediately
-4. **Smooth Transition**: CSS transitions between themes
-
-### Troubleshooting
-
-**Viewer Not Loading:**
-```bash
-# Check worker status
-npm run worker:logs
-
-# Restart worker
-npm run worker:restart
-
-# Check if port 37777 is available
-lsof -i :37777
-```
-
-**SSE Connection Issues:**
-- Check browser console for connection errors
-- Verify no proxy/firewall blocking EventSource
-- Auto-reconnect attempts every 1-5s with exponential backoff
-
-**Theme Not Persisting:**
-- Check localStorage: `localStorage.getItem('theme-preference')`
-- Verify `/api/settings` endpoint responding
-- Clear browser cache if stale
-
-**Infinite Scroll Not Triggering:**
-- Scroll to 80% of feed height
-- Check browser console for fetch errors
-- Verify `/api/{type}` endpoints responding with data
-
-## Development
-
-### Building the Viewer
-
-```bash
-# Build viewer UI
-npm run build
-
-# Output: plugin/ui/viewer.html (self-contained)
-```
-
-### Adding New Features
-
-**Example: Add a new card component**
-
-1. Create component:
-```typescript
-// src/ui/viewer/components/cards/MyCard.tsx
-export function MyCard({ data }: { data: MyData }) {
- return (
-
-
{data.title}
-
{data.content}
-