How traycerai/traycer works
Traycer is an AI-agent orchestration workspace: users connect existing coding agents, work with shared context, and coordinate agents and teammates. The desktop and mobile clients present the workspace; desktop code also manages a local Host and its CLI, while shared host-selection and transport modules support host connectivity. The README documents major capabilities, but the excerpts do not expose the full GUI-to-Host execution path, so those relationships are shown only where documented and otherwise omitted.
Main entry points: auth-service.ts Workspace UI · main.tsx Desktop renderer · main-process.ts Electron main · host-controller.ts Host controller
Components 18
Workspace clients
- Workspace UI
clients/gui-app/src/lib/auth/auth-service.ts - Mobile client
clients/mobile/src/web/main.tsx - Desktop renderer
clients/desktop/src/renderer-shell/main.tsx
Desktop runtime
- Electron main
clients/desktop/src/electron-main/main-process.ts - IPC bridge
clients/desktop/src/electron-main/ipc/runner-ipc-bridge.ts - Embedded browser
clients/desktop/src/electron-main/browser-view/browser-view-manager.ts - Browser state
clients/desktop/src/electron-main/browser-view/storage/browser-storage-state.ts
Host management
- Host controller
clients/desktop/src/electron-main/host/host-controller.ts - Traycer CLI
clients/desktop/src/electron-main/cli/traycer-cli.ts - Agent registry
clients/traycer-cli/src/registry/client.ts - Host diagnostics
clients/traycer-cli/src/doctor/engine.ts
Shared services
- Host selection
clients/shared/host-selection/selection-authority-engine.ts - Reconnect engine
clients/shared/host-client/host-connection-reconnect-engine.ts - Browser sessions
clients/shared/host-transport/browser-sessions-stream-client.ts
Orchestration
- Coding agents
- Team members
- Cloud tasks
clients/gui-app/src/hooks/epics/use-cloud-epic-tasks-query.ts
Other components
- Developer
Connections 18
- Developer → Workspace UI: uses workspace
- Developer → Desktop renderer: uses desktop
- Developer → Mobile client: uses mobile
- Workspace UI → Coding agents: connects agents
- Workspace UI → Team members: collaborates with
- Team members → Cloud tasks: assigns tickets
- Workspace UI → Cloud tasks: views task work
- Desktop renderer → Electron main: uses desktop runtime
- Electron main → IPC bridge: registers bridge
- Electron main → Host controller: manages Host
- Host controller → Traycer CLI: runs CLI
clients/desktop/src/electron-main/host/host-controller.ts - Host controller → Agent registry: checks releases
- Host diagnostics → Agent registry: checks versions
- Desktop renderer → Embedded browser: uses browser
- Embedded browser → Browser state: captures state
- Workspace UI → Host selection: selects Host
- Workspace UI → Reconnect engine: reopens connection
- Workspace UI → Browser sessions: streams sessions