How tank550/focus_os works
Focus OS is a local-first personal execution desktop app: users capture thoughts in Inbox, explicitly request AI analysis and confirm actionable proposals, organize work as projects/goals/tasks, then plan and run focus sessions. Settings and GitHub-based portfolio review are separate capabilities. The graph follows the frontend-to-command-to-application flow where evidence supports it; unsampled command and service wiring is represented conservatively. SQLite is the local source of truth; the README documents NIM and GitHub workflows.
Main entry points: commands Tauri commands · tasks.rs Task execution · agent.rs Proposal agent · tauri.ts Tauri bridge
Components 24
Desktop experience
- Product screens
src/features - UI state
src/stores - Tauri bridge
src/lib/tauri.ts - IPC contracts
src/shared/contracts.ts
Application workflows
- Tauri commands
src-tauri/src/commands - Inbox analysis
src-tauri/src/application/inbox.rs - Proposal agent
src-tauri/src/application/agent.rs - Task execution
src-tauri/src/application/tasks.rs - Project management
src-tauri/src/application/projects.rs - Goals sidecar
src-tauri/src/application/goals.rs - Daily planner
src-tauri/src/application/planner.rs - Portfolio review
src-tauri/src/application/portfolio.rs - Settings service
src-tauri/src/application/settings.rs
Persistence and integrations
- Shared app state
src-tauri/src/state.rs - SQLite database
src-tauri/src/infrastructure/db/mod.rs - Task repository
src-tauri/src/infrastructure/repositories/tasks_repo.rs - Goal repository
src-tauri/src/infrastructure/repositories/goals_repo.rs - Domain repositories
src-tauri/src/infrastructure/repositories - AI provider
src-tauri/src/infrastructure/ai.rs - GitHub integration
src-tauri/src/infrastructure/github.rs
Domain model
- Focus domain
crates/focus-domain/src/status.rs
Other components
- User
- NVIDIA NIM
- GitHub
Connections 29
- User → Product screens: uses
- Product screens → UI state: dispatches
src/App.tsx - UI state → Tauri bridge: invokes
src/stores/appStore.ts - Tauri bridge → IPC contracts: types with
src/lib/tauri.ts - Tauri bridge → Tauri commands: invokes commands
src/lib/tauri.ts - Tauri commands → Task execution: delegates
src-tauri/src/commands/tasks.rs - Task execution → Task repository: reads and writes
src-tauri/src/application/tasks.rs - Task execution → Goal repository: records sidecar
src-tauri/src/application/tasks.rs - Task repository → SQLite database: queries
src-tauri/src/infrastructure/repositories/tasks_repo.rs - Goal repository → SQLite database: queries
src-tauri/src/infrastructure/repositories/goals_repo.rs - Shared app state → SQLite database: pools connections
src-tauri/src/state.rs - Task execution → Shared app state: leases connection
src-tauri/src/application/tasks.rs - Goals sidecar → Goal repository: uses
src-tauri/src/application/goals.rs - Goals sidecar → Shared app state: leases connection
src-tauri/src/application/goals.rs - Tauri commands → Inbox analysis: routes inbox
- Inbox analysis → Proposal agent: requests proposals
- Proposal agent → AI provider: requests analysis
- AI provider → NVIDIA NIM: sends analysis
README.md - Proposal agent → Task execution: applies confirmed task
README.md - Proposal agent → Project management: applies confirmed project
README.md - Tauri commands → Daily planner: routes planning
- Daily planner → Domain repositories: loads and saves plan
- Tauri commands → Portfolio review: routes assessment
- Portfolio review → GitHub integration: inspects repository
README.md - GitHub integration → GitHub: lists repositories
README.md - Portfolio review → AI provider: assesses summary
README.md - Tauri commands → Settings service: routes settings
- Settings service → Domain repositories: persists settings
- Task execution → Focus domain: validates task status
src-tauri/src/application/tasks.rs