How cakahlul/odwyn works
Odwyn is a self-hosted AI-agent workspace. Users configure agents and providers, then send goals to an agent or collaborative room; the runtime coordinates provider turns and tools, and users review results, approvals, and activity. Reusable workflows and skills, browser takeover, knowledge, files, workspace management, and Oddy extend that core. The excerpts show selected calls and imports; other documented capabilities are included without asserting unsampled implementation links.
Main entry points: runtime.js Job runtime · app.js Web application · server.js HTTP application · store.js Workspace store
Components 27
Workspace experience
- Web application
public/app.js - Workspace interface
public/ui.js - Chat and room views
public/views.js - Workflow interface
public/workflows-ui.js - Activity interface
public/audit-ui.js - Connections interface
public/connections-ui.js
Task orchestration
- HTTP application
server.js - Job runtime
runtime.js - Room coordination
room-work.js - Room stages
room-stages.js - Workflow engine
workflows.js
Agent capabilities
- Persistent browser
browser.js - Host terminal
terminal.js - Workspace files
files.js - Knowledge and search
knowledge.js - Oddy assistant
oddy.js
Workspace data
- Workspace store
store.js - Security controls
security.js - Audit history
audit.js - Conversation reports
conversation-reports.js
Providers and services
- Provider gateway
providers.js - Codex adapter
codex.js - Antigravity adapter
antigravity.js - Browser proxy
proxy.js - Usage accounting
usage.js - Provider connections
connections.js
Other components
- Workspace user
Connections 37
- Workspace user → Web application: uses
README.md - Web application → Workflow interface: sets up
public/app.js - Web application → Activity interface: sets up
public/app.js - Web application → Connections interface: sets up
public/app.js - Web application → Chat and room views: renders
public/app.js - Web application → Workspace interface: uses
public/app.js - Workflow interface → HTTP application: runs workflows
public/workflows-ui.js - HTTP application → Job runtime: dispatches jobs
server.js - HTTP application → Workspace store: uses
server.js - HTTP application → Security controls: validates input
server.js - HTTP application → Provider connections: manages connections
server.js - HTTP application → Conversation reports: serves reports
server.js - Job runtime → Provider gateway: executes turns
runtime.js - Job runtime → Workflow engine: runs steps
runtime.js - Job runtime → Room coordination: coordinates rooms
runtime.js - Job runtime → Room stages: advances stages
runtime.js - Job runtime → Workspace store: saves state
runtime.js - Job runtime → Oddy assistant: delegates assistant
runtime.js - Job runtime → Workspace files: uses files
runtime.js - Job runtime → Host terminal: runs commands
runtime.js - Job runtime → Knowledge and search: uses knowledge
runtime.js - Room coordination → Room stages: uses stages
room-work.js - Room coordination → Workspace store: reads state
room-work.js - Room coordination → Workspace files: uses files
room-work.js - Provider gateway → Codex adapter: delegates
providers.js - Provider gateway → Antigravity adapter: delegates
providers.js - Provider gateway → Usage accounting: records usage
providers.js - Persistent browser → Browser proxy: starts proxy
browser.js - Persistent browser → Security controls: validates navigation
browser.js - Workspace store → Audit history: opens audit
store.js - Workspace store → Knowledge and search: opens knowledge
store.js - Workspace store → Security controls: validates data
store.js - Connections interface → Workflow interface: uses
public/connections-ui.js - Activity interface → Workspace interface: uses
public/audit-ui.js - Chat and room views → Workspace interface: uses
public/views.js - Workspace user → Persistent browser: takes over browsing
README.md - Workspace user → Workflow engine: reuses routines
README.md