How sant0x00/orca works
Orca is a cross-platform AI coding-agent workspace: users start agents in chat or terminals, isolate parallel work in worktrees, and review and hand feedback back to agents. The README also describes orchestration, remote execution, mobile notifications and replies, Git integrations, browser design mode, task integrations, CLI, and plugins. The graph preserves those product branches, while sampled source supports a few internal review and query details. Most subsystems are represented at their existing source directories because their implementations were not sampled; documented links use the README as evidence.
Main entry points: handlers Agent orchestration · mobile Mobile companion · native-chat Chat and terminal · useRichMarkdownReviewController.ts Diff review
Components 20
User experience
- Desktop app
src/renderer/src - Chat and terminal
src/main/native-chat - Diff review
src/renderer/src/components/editor/rich-markdown/review/useRichMarkdownReviewController.ts - Mobile companion
mobile - Session search
src/main/ai-vault-search/query/session-search-engine.ts - Review rail
src/renderer/src/components/editor/rich-markdown/review/useRichMarkdownReviewRailController.ts - Mobile diff review
mobile/src/source-control/review/use-mobile-diff-review-controller.ts
Agent work
- Agent orchestration
src/cli/handlers - Parallel worktrees
src/main/workspaces - Agent runtime
src/main/runtime - Orca CLI
src/cli
Execution platform
- Remote Orca Server
cloud/apps/relay - Relay edge
cloud/apps/relay-edge - Fence broker
cloud/apps/relay-fence-broker - Push service
cloud/apps/push
Integrations
- Git and PRs
src/main/runtime/integrations/github/runtime-github-repository-query-commands.ts - GitHub and Linear tasks
src/main/runtime/integrations - Browser design mode
src/renderer/src/components/browser-pane - Plugin system
src/shared/plugins
Other components
- Builder
Connections 24
- Builder → Desktop app: uses
- Desktop app → Chat and terminal: starts agents
- Chat and terminal → Agent runtime: runs agents
- Builder → Agent orchestration: delegates tasks
- Agent orchestration → Parallel worktrees: starts workers
- Agent orchestration → Agent runtime: dispatches work
- Builder → Parallel worktrees: creates workspaces
- Builder → Diff review: reviews changes
- Diff review → Review rail: delegates rail
src/renderer/src/components/editor/rich-markdown/review/useRichMarkdownReviewController.ts - Builder → Mobile companion: uses remotely
- Mobile companion → Mobile diff review: reviews diffs
mobile/src/source-control/review/use-mobile-diff-review-controller.ts - Mobile companion → Push service: receives alerts
- Builder → Remote Orca Server: pairs remotely
- Remote Orca Server → Relay edge: uses relay
- Relay edge → Fence broker: coordinates fences
- Builder → Orca CLI: runs commands
- Orca CLI → Agent orchestration: starts workers
src/cli/handlers/orchestration-handler-test-context.ts - Builder → Git and PRs: reviews PRs
- Builder → GitHub and Linear tasks: starts from tasks
- Builder → Browser design mode: selects elements
- Browser design mode → Chat and terminal: sends context
- Builder → Plugin system: installs plugins
- Builder → Session search: searches sessions
- Review rail → Diff review: positions notes
src/renderer/src/components/editor/rich-markdown/review/useRichMarkdownReviewRailController.ts