How 2sincejuly/skydot works
SkyDot is a self-hosted multi-user agent workspace: users configure a Dot and workspace, submit conversations or scheduled work, and receive streamed results, collaboration updates, or approval requests. The documented execution boundary places orchestration and persistence in the backend and agent work in a Host or Docker runner; the shared web client is also used by PWA and Electron. The README supports the major capability branches shown here. Some subsystem links are documented rather than verified in sampled implementation, so those edges cite the README.
Main entry points: src/index.ts Backend Service · src/index.ts Agent Runner · App.tsx Web and PWA · product-runtime-store.ts Product Runtime State
Components 18
Clients
- Web and PWA
web/src/App.tsx - Electron Desktop
electron/src/main/index.ts
Backend Control Plane
- Authentication and ACL
src/middleware/auth.ts - Backend Service
src/index.ts - SQLite Persistence
src/db.ts - Channel Connections
src/im-manager.ts - Task Scheduling
src/task-scheduler.ts - Product Runtime State
src/personal-agent/product-runtime-store.ts
Agent Execution
- Agent Runner
container/agent-runner/src/index.ts - Pi Runtime
container/agent-runner/src/runtime/pi/pi-runtime.ts - Cloud Runtime
apps/cloud-agent/src/session-object.ts
Collaboration
- Group Discussions
src/bot-groups/discussion-service.ts - Bot Handoffs
src/bot-groups/handoff-service.ts
Work Capabilities
- Skills and Plugins
src/plugin-catalog.ts - MCP Integrations
src/mcp-client.ts - Workspace Memory
src/memory-service.ts - Goals and Durable Work
src/personal-agent/goal-runtime.ts
Other components
- User
Connections 21
- User → Web and PWA: uses
- Web and PWA → Authentication and ACL: requests backend
- Electron Desktop → Web and PWA: shares frontend
- Authentication and ACL → Backend Service: guards access
- Backend Service → SQLite Persistence: persists state
- Backend Service → Agent Runner: dispatches execution
- Agent Runner → Pi Runtime: runs agent
- Backend Service → Channel Connections: connects channels
- Channel Connections → Backend Service: routes messages
- Backend Service → Task Scheduling: schedules work
- Task Scheduling → Agent Runner: starts runs
- Backend Service → Group Discussions: serves collaboration
- Group Discussions → Bot Handoffs: delegates bot work
src/bot-groups/discussion-service.ts - Bot Handoffs → Product Runtime State: uses runtime state
src/bot-groups/handoff-service.ts - Backend Service → Product Runtime State: manages sessions
- Agent Runner → Skills and Plugins: loads capabilities
- Agent Runner → MCP Integrations: invokes tools
- Agent Runner → Workspace Memory: uses workspace knowledge
- Backend Service → Goals and Durable Work: supports durable goals
- Goals and Durable Work → Product Runtime State: tracks execution
- Backend Service → Cloud Runtime: optionally dispatches