How zemeng5208/personalagent works
PersonalAgent is a Windows-oriented persistent personal assistant, entered through a floating orb, with proactive prompts and bounded computer actions. Its intended path runs from desktop interaction through the local Runtime, which retains authorization and real execution/readback/evidence responsibilities; AgentArts is the competition orchestration target but README reports no production adapter or end-to-end evidence yet. The graph preserves documented memory, connectors, productivity, voice, and repair capabilities. Several links are omitted because the sampled excerpts do not establish their runtime wiring.
Main entry points: runtime-application.ts Runtime Application · connectors Platform Connectors · main.js Electron Main · windows-host-adapter.ts Windows Host Adapter
Components 26
Desktop Experience
- Floating Orb
apps/desktop/src/features/orb/orb.js - Desktop Renderer
apps/desktop/src/app/renderer.js - Electron Main
apps/desktop/electron/main.js - Desktop Runtime Bridge
apps/desktop/electron/runtime.js
Local Runtime
- Runtime Application
apps/runtime/src/application/runtime-application.ts - Authorization Store
apps/runtime/src/authorization-store.ts - Windows Host Adapter
apps/runtime/src/application/windows-host-adapter.ts - Scoped Evidence Reader
apps/runtime/src/application/evidence-reader.ts - Competition Fact Host
apps/runtime/src/application/competition-fact-host.ts
Agent Cognition
- AgentArts Runtime
apps/runtime/src/application/agentarts.ts - Cognition
packages/cognition/src/index.ts - Coordination
packages/coordination/src/index.ts - Memory Feed
packages/memory/src/feed.ts - Notification Service
packages/notifications/src/service.ts - Todo Service
packages/productivity/src/service.ts
Platform Capabilities
- Platform Connectors
packages/connectors - Feed Connector
packages/connectors/feeds/src/service.ts - Mail Connector
packages/connectors/mail/src/service.ts - Calendar Connector
packages/connectors/calendar/src/service.ts - Weather Connector
packages/connectors/weather/src/service.ts - Research Connector
packages/connectors/research/src/service.ts - Voice Sessions
packages/voice/src/voice-session.ts - Workspace Patch Preview
packages/coding-tools/src/patch-preview.ts
Other components
- User
- AgentArts Platform
- Windows Host
Connections 21
- User → Floating Orb: interacts
- Floating Orb → Desktop Renderer: presents
- Electron Main → Desktop Runtime Bridge: registers
- Electron Main → Authorization Store: reads approvals
- Electron Main → Runtime Application: calls queries
- Runtime Application → Authorization Store: authorizes
- Runtime Application → Windows Host Adapter: dispatches host tasks
- Runtime Application → Scoped Evidence Reader: reads evidence
- Runtime Application → Competition Fact Host: projects facts
- AgentArts Runtime → AgentArts Platform: orchestrates
- Windows Host Adapter → Windows Host: executes
- Cognition → Coordination: coordinates
- Cognition → Memory Feed: uses memory
- Notification Service → Todo Service: supports reminders
- Feed Connector → Platform Connectors: provides feed input
- Mail Connector → Platform Connectors: provides mail actions
- Calendar Connector → Platform Connectors: provides calendar actions
- Weather Connector → Platform Connectors: provides forecasts
- Research Connector → Platform Connectors: provides research
- Voice Sessions → Desktop Renderer: supports voice input
- Workspace Patch Preview → Windows Host Adapter: previews patches