How osadeoss/osade works
Osade is a local-first agentic development environment: users direct coding agents in a desktop workspace, review their changes, verify work, and approve publishing actions. The README documents the user-facing workflow and capabilities; the sampled source confirms desktop task orchestration, daemon routing, and portions of the terminal API. Some runtime links—especially between desktop, daemon, and terminal backend—are not directly shown in the excerpts, so those are marked unverified rather than asserted as calls.
Main entry points: App.tsx Desktop app · ui.rs Terminal interface · launch-task.ts Agent execution · router.ts Task API
Components 34
Desktop workspace
- Desktop app
apps/desktop/src/renderer/App.tsx - Chat composer
apps/desktop/src/renderer/Composer.tsx - Browser view
apps/desktop/src/renderer/BrowserPane.tsx - Files and changes
apps/desktop/src/renderer/Files.tsx - Task board
apps/desktop/src/renderer/Board.tsx
Agent work
- Chat context
packages/daemon/src/domain/chat-context.ts - Agent execution
packages/daemon/src/domain/launch-task.ts - Agent catalog
packages/daemon/src/domain/agent-catalog.ts - Git and worktrees
packages/daemon/src/domain/git.ts - Repository rules
packages/daemon/src/knowledge/repo-rules.ts - Repository knowledge
packages/daemon/src/knowledge/service.ts
Review and delivery
- Verification plans
packages/daemon/src/domain/verify-plan.ts - Approval gates
packages/daemon/src/domain/gates.ts - Quick notes
packages/daemon/src/domain/quick-notes.ts
Daemon services
- Task API
packages/daemon/src/server/router.ts - Task database
packages/daemon/src/db/index.ts
Terminal platform
- Terminal interface
backend/src/ui.rs - Terminal sessions
backend/src/terminal - Pane and layout state
backend/src/layout.rs - Terminal API
backend/src/api/server.rs - API schema
backend/src/api/schema.rs - Terminal configuration
backend/src/config.rs - Terminal graphics
backend/src/kitty_graphics.rs - Wire protocol
backend/src/protocol/endpoint.rs - Session control
backend/src/session.rs - Local IPC
backend/src/ipc.rs - Agent detection
backend/src/detect/manifest_update.rs - Terminal client
backend/src/server/client_transport.rs - API subscriptions
backend/src/api/subscriptions.rs - Application state
backend/src/app/state.rs - Release notes
backend/src/release_notes.rs - Input handling
backend/src/raw_input.rs
Other components
- Developer
- Source control host
Connections 33
- Developer → Desktop app: opens repository
README.md - Desktop app → Chat composer: starts conversations
README.md - Chat composer → Agent catalog: selects agents
- Desktop app → Task API: requests task services
- Task API → Task database: reads and writes
packages/daemon/src/server/router.ts - Task API → Chat context: builds chat context
packages/daemon/src/server/router.ts - Task API → Agent execution: launches agents
packages/daemon/src/server/router.ts - Agent execution → Git and worktrees: isolates work
README.md - Agent execution → Repository rules: loads repository rules
README.md - Agent execution → Quick notes: includes open notes
README.md - Agent execution → Repository knowledge: uses repository knowledge
- Desktop app → Task board: shows task status
README.md - Desktop app → Files and changes: reviews changes
README.md - Desktop app → Browser view: shows running app
README.md - Task API → Verification plans: proposes checks
README.md - Verification plans → Approval gates: gates outward actions
README.md - Approval gates → Source control host: publishes with approval
README.md - Repository knowledge → Source control host: fetches review corpus
packages/daemon/src/knowledge/service.ts - Desktop app → Terminal interface: provides terminal workspace
README.md - Terminal interface → Terminal sessions: restores sessions
README.md - Terminal sessions → Pane and layout state: organizes panes
- Terminal API → API schema: handles requests
backend/src/api/server.rs - Terminal API → Local IPC: uses local sockets
backend/src/api/server.rs - Terminal API → Application state: dispatches API requests
- Terminal client → Terminal interface: connects thin clients
backend/src/server/client_transport.rs - Terminal client → Wire protocol: uses wire protocol
backend/src/server/client_transport.rs - Terminal client → Input handling: forwards input
backend/src/server/client_transport.rs - Terminal API → API subscriptions: streams updates
backend/src/api/server.rs - Terminal interface → Terminal configuration: uses configuration
- Terminal interface → Terminal graphics: renders terminal graphics
backend/src/kitty_graphics.rs - Session control → Local IPC: derives socket paths
backend/src/session.rs - Application state → Agent detection: tracks agent state
- Terminal interface → Release notes: shows release notes