How t1mothys/orbit works
Orbit is a chat-first personal workspace, available as Web and Electron. A user signs in, starts in the main conversation, and uses it to manage schedules, reminders, notes, and other personal work; schedule writes require confirmation. Separate areas provide knowledge/library, search, research, and local or cloud daily reports. The server exposes authenticated routes and persists application data across database stores; optional CalDAV, mail, AI providers, and cloud reporting extend the core. The graph combines README capabilities with indexed and excerpted source; some subsystem links are documented only at product level.
Main entry points: ai.ts AI conversation · application.ts HTTP application · App.tsx Web app · search-service.ts Global search
Components 23
User experience
- Web app
src/App.tsx - Authentication
src/hooks/useAuth.ts - Electron host
electron/main.ts
Conversation and planning
- AI conversation
server/routes/ai.ts - Chat experience
src/hooks/useOrbitChat.ts - Conversation queue
server/orbit-queue.ts - Schedule management
server/schedule-store.ts - Reminders
server/reminder-store.ts - CalDAV bridge
server/caldav-service.ts - AI providers
server/ai-provider-contract.ts
Knowledge and research
- Notes and images
server/note-item-service.ts - Knowledge library
server/library-service.ts - Global search
server/search-service.ts - Digest research
server/digest-research-store.ts - Digest V3
server/digest-v3-store.ts
Reports and activity
- Activity reports
server/activity-store.ts - Daily reports
server/daily-report-service.ts - Cloud reporting
server/daily-report-cloud-store.ts - Email service
server/email-service.ts
Server and persistence
- HTTP application
server/application.ts - Application database
server/database/connection.ts - Durable persistence
server/persistence.ts
Other components
- User
Connections 26
- User → Web app: uses
README.md - Web app → Authentication: checks session
src/App.tsx - Authentication → HTTP application: auth requests
src/hooks/useAuth.ts - Web app → HTTP application: uses API
- Electron host → Web app: hosts
- HTTP application → AI conversation: mounts routes
server/application.ts - HTTP application → Global search: mounts routes
- HTTP application → Digest research: mounts routes
server/application.ts - HTTP application → Digest V3: mounts routes
server/application.ts - Chat experience → AI conversation: sends messages
- AI conversation → Conversation queue: queues work
server/routes/ai.ts - AI conversation → AI providers: uses providers
server/routes/ai.ts - AI conversation → Schedule management: manages schedules
server/routes/ai.ts - AI conversation → Notes and images: manages notes
- AI conversation → Reminders: manages reminders
server/routes/ai.ts - Global search → Reminders: reads projections
server/search-service.ts - Global search → AI conversation: searches conversations
server/routes/ai.ts - Digest research → Activity reports: uses stores
server/routes/research.ts - Digest V3 → Activity reports: persists digest data
server/activity-store.ts - Daily reports → Activity reports: stores reports
- Daily reports → Cloud reporting: uses cloud store
- CalDAV bridge → Schedule management: reads schedules
server/caldav-service.ts - CalDAV bridge → Reminders: reads reminders
server/caldav-service.ts - Application database → Durable persistence: persists database
server/database/connection.ts - HTTP application → Application database: initializes stores
- Email service → Daily reports: delivers reports