How dassiorleando/openworker works
OpenWorker is a local-first desktop AI coworker: a user chooses a specialist, gives it a task, and receives a deliverable through a governed agent loop. The documented workflow spans model selection, tool use across local files and connected services, approval, and transcript-backed results. The graph includes the server and GUI surfaces, runtime orchestration, governance, integrations, and documented scheduling, teams, and sandbox capabilities. Several subsystem links are README-documented rather than verified in sampled implementation; those are marked dashed.
Main entry points: engine.py Turn engine · manager.py Session manager · registry.py Built-in tools · App.tsx Desktop GUI
Components 24
User surfaces
- Desktop GUI
surfaces/gui/src/App.tsx - Server API
coworker/server/app.py
Agent runtime
- Session manager
coworker/server/manager.py - Personas
coworker/personas/registry.py - Agent setup
coworker/agent.py - Turn engine
coworker/engine.py - Model providers
coworker/providers/router.py
Governance and state
- Permission engine
coworker/permissions.py - Auto-approve reviewer
coworker/reviewer.py - Audit trail
coworker/audit.py - Conversations
coworker/conversations.py
Tools and integrations
- Built-in tools
coworker/tools/registry.py - App integrations
coworker/connectors/integration_tools.py - MCP connections
coworker/mcp/client.py - Command sandbox
coworker/sandbox/client.py
Extended capabilities
- Unattended inbox
coworker/inbox.py - Scheduled automations
coworker/automation/scheduler.py - Teams
coworker/teams/store.py - Messaging connectors
coworker/connectors/relay_client.py
Other components
- User
- Local files
- Connected apps
- Model service
- Finished work
Connections 23
- User → Desktop GUI: requests work
- Desktop GUI → Server API: uses API
- Server API → Session manager: routes requests
coworker/server/app.py - Session manager → Personas: resolves persona
coworker/server/manager.py - Session manager → Agent setup: builds agent
coworker/agent.py - Agent setup → Turn engine: creates loop
coworker/agent.py - Turn engine → Model providers: requests completion
coworker/engine.py - Turn engine → Permission engine: checks actions
coworker/engine.py - Turn engine → Auto-approve reviewer: consults reviewer
coworker/engine.py - Turn engine → Built-in tools: dispatches calls
coworker/engine.py - Turn engine → Conversations: persists conversation
- Turn engine → Audit trail: records actions
- Model providers → Model service: calls model
coworker/providers/router.py - Built-in tools → Local files: works on files
- Built-in tools → Command sandbox: runs commands
- Turn engine → App integrations: uses integrations
- Turn engine → MCP connections: uses MCP tools
- App integrations → Connected apps: accesses services
- Turn engine → Finished work: produces result
- Session manager → Unattended inbox: routes unattended asks
coworker/server/manager.py - Session manager → Scheduled automations: supports schedules
- Session manager → Teams: manages teams
coworker/server/manager.py - Session manager → Messaging connectors: supports messaging