How orkas-ai/orkas works
Orkas is a local-first, multi-agent desktop app: a user describes a goal in chat, the Commander coordinates work across agents and tools, and the app returns files and other results on the user’s machine. The graph highlights that workflow plus connectors, marketplace skills, and office/media capabilities documented in the README. Several feature modules are present in the tree but were not sampled; their links are included only where the README documents the relationship, and the excerpts do not establish detailed renderer-to-main wiring.
Main entry points: agents.ts Agent management · session.ts Agent session · router.ts Group chat · client.ts Model client
Components 21
Chat and coordination
- Group chat
src/main/features/group_chat/router.ts - Agent management
src/main/features/agents.ts
Agent runtime
- Model client
src/main/model/core-agent/client.ts - Agent session
src/core-agent/src/agent/session.ts - Tool definitions
src/core-agent/src/tools/base.ts - Local agent sessions
src/main/features/local_agents/runner.ts - Skills and memory
src/main/features/skills.ts
Tools and integrations
- Connector manager
src/main/features/connectors/manager.ts - Connector catalog
src/main/features/connectors/catalog.ts - Agent marketplace
src/main/features/marketplace.ts - Recurring tasks
src/main/features/auto_tasks.ts - Knowledge base
src/main/features/kb_indexer.ts - Web apps
src/main/features/web_apps/runtime.ts
Local data and deliverables
- Office engine
src/main/features/office/office_engine.ts - Video studio
src/main/features/video_studio.ts - Image studio
src/main/features/image_studio.ts - Local persistence
src/main/storage.ts - User data layout
src/main/paths.ts
Other components
- Desktop user
- Model provider
- User files
Connections 24
- Desktop user → Group chat: describes goal
README.md - Group chat → Agent management: coordinates agents
src/main/features/group_chat/router.ts - Group chat → Local persistence: persists conversation
src/main/features/group_chat/router.ts - Agent management → Model client: starts model run
- Model client → Agent session: builds runner
src/main/model/core-agent/client.ts - Agent session → Tool definitions: uses tools
src/core-agent/src/agent/session.ts - Model client → Model provider: sends model requests
README.md - Agent management → Skills and memory: uses skills and memory
src/main/features/agents.ts - Agent management → Local agent sessions: coordinates local agents
README.md - Agent management → Agent marketplace: offers agents
README.md - Agent session → Connector manager: uses integrations
- Connector manager → Connector catalog: resolves catalog
src/main/features/connectors/manager.ts - Group chat → Recurring tasks: schedules recurring work
- Agent session → Knowledge base: searches documents
- Agent session → Web apps: uses local apps
- Agent management → Office engine: creates office files
README.md - Agent management → Video studio: drives video work
README.md - Agent management → Image studio: creates images
README.md - Office engine → User files: reads and writes files
README.md - Video studio → User files: delivers video files
README.md - Image studio → User files: delivers image files
README.md - Local persistence → User data layout: uses data paths
src/main/storage.ts - Local persistence → User files: stores local data
README.md - Desktop user → User files: receives results
README.md