How arafa1974/openhands works
Agent Canvas is a self-hosted developer control center for running coding agents and automations across local, remote, and cloud backends. A user selects a backend, starts or resumes a conversation, and works with agent events, files, browser, and terminal views; automations provide a separate scheduled or webhook-triggered workflow. The graph also includes model profiles, cloud services, and extensions as major product capabilities. Source excerpts establish backend selection and conversation-history access; several UI and automation links are documented capabilities, so their implementation relationships are left unasserted.
Main entry points: chat-interface.tsx Conversation workspace · conversation-history-query-options.ts Conversation history · active-store.ts Active backend registry · agent-server-client-options.ts Agent client options
Components 20
Backend access
- Backend controls
src/components/features/backends/backend-selector.tsx - Active backend registry
src/api/backend-registry/active-store.ts - Backend persistence
src/api/backend-registry/storage.ts - Agent client options
src/api/agent-server-client-options.ts - Agent server
Agent conversations
- Conversation workspace
src/components/features/chat/chat-interface.tsx - Conversation service
src/api/conversation-service/agent-server-conversation-service.api.ts - Conversation history
src/hooks/query/conversation-history-query-options.ts - Event service
src/api/event-service/event-service.api.ts - Agent event views
src/components/conversation-events/chat/messages.tsx - Conversation preferences
src/utils/conversation-local-storage.ts
Automations
- Automation workflows
src/components/features/automations/automation-card.tsx - Automation service
src/api/automation-service/automation-service.api.ts - Workflow integrations
src/api/automation-setup-plugins.ts
Product platform
- Model profiles
src/components/features/settings/llm-profiles/llm-profiles-manager.tsx - Profiles service
src/api/profiles-service/profiles-service.api.ts - Cloud services
src/api/cloud/client.ts - Canvas extensions
src/api/canvas-extensions-service.ts - Embeddable UI
src/lib/index.ts
Other components
- Developer
Connections 20
- Developer → Backend controls: chooses backend
README.md - Active backend registry → Backend persistence: reads and writes
src/api/backend-registry/active-store.ts - Active backend registry → Agent client options: resolves backend
src/api/agent-server-client-options.ts - Agent client options → Agent server: configures requests
- Developer → Conversation workspace: starts conversation
README.md - Conversation workspace → Conversation service: manages conversations
- Conversation service → Agent server: sends agent requests
- Conversation history → Event service: loads history
src/hooks/query/conversation-history-query-options.ts - Event service → Agent server: requests events
- Conversation workspace → Conversation history: queries history
- Conversation workspace → Conversation preferences: persists preferences
- Conversation history → Agent event views: provides event history
- Developer → Automation workflows: creates workflows
README.md - Automation workflows → Automation service: manages automations
- Automation service → Workflow integrations: uses integrations
- Developer → Model profiles: configures models
README.md - Model profiles → Profiles service: loads and saves
src/components/features/settings/llm-profiles/llm-profiles-manager.tsx - Developer → Cloud services: connects cloud
README.md - Developer → Canvas extensions: adds extensions
- Embeddable UI → Developer: exposes UI components