How treyu23/operatingsystemchatgpt works
Live Desktop is a local-first Windows dashboard and assistant. A user interacts with the React dashboard to inspect system status, manage profile data, chat, review approvals, and use calendar and media integrations. The frontend sends API requests to the Spring controller, which delegates to assistant, system, integration, action, and persistence services. Approved actions execute only after approval (or a matching prior approval). The README documents additional capabilities whose implementation was not sampled; those are represented at the documented service boundaries. The frontend and several backend links are based on the tree and README, not inspected source.
Main entry points: AssistantController.java API controller · DashboardContextService.java Prompt context · ActionService.java Approval actions · SystemService.java System inspection
Components 24
Dashboard
- React dashboard
frontend/src/App.jsx
API and assistant
- API controller
backend/src/main/java/com/localassistant/os/web/AssistantController.java - OpenAI agent
backend/src/main/java/com/localassistant/os/agent/OpenAiAgent.java - Prompt context
backend/src/main/java/com/localassistant/os/service/DashboardContextService.java - Approval actions
backend/src/main/java/com/localassistant/os/service/ActionService.java
Profiles and state
- Local state
backend/src/main/java/com/localassistant/os/store/StateStore.java - Memory service
backend/src/main/java/com/localassistant/os/service/MemoryService.java - Profile data
backend/src/main/java/com/localassistant/os/service/ProfileDataService.java - Protected credentials
backend/src/main/java/com/localassistant/os/service/ProfileCredentialStore.java
Windows desktop
- System inspection
backend/src/main/java/com/localassistant/os/service/SystemService.java - Radio controls
backend/src/main/java/com/localassistant/os/service/WindowsSystemControlService.java - Runtime controls
backend/src/main/java/com/localassistant/os/service/RuntimeService.java - Workspace access
backend/src/main/java/com/localassistant/os/service/WorkspaceService.java - Media controls script
scripts/windows-media-session.ps1 - Radio control script
scripts/windows-system-control.ps1
Connected services
- Media session
backend/src/main/java/com/localassistant/os/service/WindowsMediaSessionService.java - iCloud Calendar
backend/src/main/java/com/localassistant/os/service/ICloudCalendarService.java - Phone Link status
backend/src/main/java/com/localassistant/os/service/SystemService.java
Other components
- User
- OpenAI API
- iCloud CalDAV
- Music web embeds
- Phone Link
- Windows
Connections 33
- User → React dashboard: uses
- React dashboard → API controller: calls API
- API controller → OpenAI agent: requests reply
- OpenAI agent → OpenAI API: sends prompt
- OpenAI agent → Prompt context: gets context
- Prompt context → System inspection: reads status
- Prompt context → Runtime controls: reads status
- Prompt context → iCloud Calendar: reads events
- Prompt context → Media session: reads session
- Prompt context → Approval actions: lists approvals
- Prompt context → Local state: reads snapshot
- API controller → Local state: stores conversations
- API controller → Approval actions: proposes actions
- API controller → Memory service: manages memories
- API controller → Profile data: manages profile
- API controller → Protected credentials: manages keys
- API controller → System inspection: gets system data
- API controller → Runtime controls: gets runtime
- API controller → iCloud Calendar: manages calendar
- API controller → Media session: controls playback
- API controller → Workspace access: accesses workspace
- Approval actions → Local state: stores actions
- Approval actions → Memory service: executes remember
- Approval actions → Workspace access: writes files
- Approval actions → Radio controls: sets control
- System inspection → Radio controls: reads controls
- Radio controls → Radio control script: runs script
- Media session → Media controls script: runs script
- Radio control script → Windows: controls radios
- Media controls script → Windows: reads and controls
- System inspection → Phone Link: inspects metadata
- iCloud Calendar → iCloud CalDAV: uses CalDAV
- React dashboard → Music web embeds: embeds player