How tomotsugu-dev/hindsight works
Hindsight is a local-first desktop activity log and AI review tool. Its principal workflow records app/window activity in the background, persists it locally, and presents time-use summaries across day, week, and month views. Users can also search optional screenshot/OCR memory, request AI summaries or chat over their records, and optionally aggregate activity across devices through cloud sync. The tree and README establish these product areas; several backend integrations and command-to-UI links are unsampled, so those relationships are shown as unverified rather than asserted.
Main entry points: App.tsx Desktop app · service.rs Activity capture · AISettingsPage.tsx AI configuration · activities.rs Activity records
Components 19
Capture and memory
- Activity capture
src-tauri/src/capture/service.rs - Activity records
src-tauri/src/repo/activities.rs - Local database
src-tauri/src/storage/pool.rs - Screen memory
src-tauri/src/memory/mod.rs - OCR processing
src-tauri/src/ai/ocr_worker.rs
Activity review
- Desktop app
src/App.tsx - Screen search
src/pages/Search/SearchPage.tsx - Time summaries
src/pages/Today/TodayPage.tsx - History views
src/pages/History/HistoryPage.tsx - Categories
src/pages/Categories/CategoriesPage.tsx
AI features
- AI reports
src-tauri/src/ai/summary.rs - AI chat
src-tauri/src/chat/engine.rs - AI configuration
src/pages/AISettings/AISettingsPage.tsx - Model runtime
src-tauri/src/ai/server.rs
Settings and sync
- Frontend API
src/api/hindsight.ts - App settings
src-tauri/src/repo/settings.rs - Device sync
src-tauri/src/sync/engine/mod.rs
Other components
- User
- Cloud provider
Connections 23
- User → Desktop app: opens and reviews
README.md - Desktop app → Time summaries: routes to
src/App.tsx - Desktop app → History views: routes to
src/App.tsx - Desktop app → Screen search: routes to
src/App.tsx - Desktop app → AI configuration: routes to
src/App.tsx - User → Activity capture: uses automatic tracking
README.md - Activity capture → Activity records: records activity
src-tauri/src/capture/service.rs - Activity records → Local database: persists records
- User → Time summaries: reviews daily, weekly, monthly
README.md - User → Categories: customizes categories
README.md - User → Screen memory: enables optional memory
README.md - Activity capture → Screen memory: registers captured frames
src-tauri/src/capture/service.rs - Screen memory → OCR processing: provides frames for OCR
- User → Screen search: searches screen text
README.md - User → AI reports: requests activity report
README.md - User → AI chat: asks about records
README.md - AI chat → Activity records: queries records
- AI configuration → Frontend API: configures AI
- Frontend API → Model runtime: invokes backend commands
- AI configuration → Model runtime: configures model runtime
- User → Device sync: opts into device sync
README.md - Device sync → Cloud provider: syncs activity metadata
README.md - App settings → Local database: stores preferences
src-tauri/src/repo/settings.rs