How maurdekye/orgtree works
Orgtree is a Windows desktop workspace for operating persistent, multi-provider coding-agent teams. A user creates or opens an organization, configures agents and permissions, assigns work, then follows conversations and coordinates through the shared docket, mail, questions, and Attention view. The renderer talks to a local Python engine; the engine runs agent/provider integrations and persists organization state and transcript records, with PostgreSQL as the documented database. The map preserves major README capabilities; some subsystem links are documented rather than confirmed in sampled implementation excerpts.
Main entry points: App.tsx Workspace UI · providers.py Provider runners · supervisor.py Agent supervisor · launch.py Local engine API
Components 22
Desktop experience
- Workspace UI
apps/desktop/renderer/src/App.tsx - UI API client
apps/desktop/renderer/src/api.ts - Engine manager
apps/desktop/main/engine.ts - Attention view
apps/desktop/renderer/src/attention/AttentionView.tsx
Engine and agents
- Local engine API
engine/launch.py - Agent supervisor
engine/backend/orgtree/supervisor.py
Organization workspace
- Org state
engine/backend/orgtree/ledger.py - Work docket
engine/backend/orgtree/workread.py - Mail and decisions
engine/backend/orgtree/reply_events.py - Transcript capture
engine/backend/orgtree/transcript_ingest.py - Transcript records
engine/backend/orgtree/transcript_records.py - Conversation history
engine/backend/orgtree/chat_window.py - V2 data import
engine/backend/orgtree/desktop_import.py
Persistence
- Store interface
engine/backend/orgtree/store.py - PostgreSQL adapter
engine/backend/orgtree/pgstore.py - PostgreSQL database
Provider integrations
- Provider runners
engine/backend/orgtree/providers.py - Claude Code
- Codex
- Antigravity
- OpenRouter
engine/backend/orgtree/openrouter.py
Other components
- User
Connections 22
- User → Workspace UI: uses
- Workspace UI → UI API client: requests data
apps/desktop/renderer/src/App.tsx - UI API client → Local engine API: calls API
- Engine manager → Local engine API: starts and attaches
apps/desktop/main/engine.ts - Local engine API → Agent supervisor: initializes
engine/launch.py - Agent supervisor → Provider runners: runs agents
- Provider runners → Claude Code: launches
- Provider runners → Codex: launches
- Provider runners → Antigravity: launches
- Provider runners → OpenRouter: routes models
- Agent supervisor → Org state: updates
- Workspace UI → Work docket: manages tickets
- Workspace UI → Mail and decisions: coordinates work
- Workspace UI → Attention view: shows attention
apps/desktop/renderer/src/App.tsx - Agent supervisor → Transcript capture: captures history
engine/backend/orgtree/transcript_ingest.py - Transcript capture → Transcript records: commits records
engine/backend/orgtree/transcript_ingest.py - Workspace UI → Conversation history: reads conversations
- Conversation history → Transcript records: reads records
engine/backend/orgtree/chat_window.py - Store interface → PostgreSQL adapter: uses adapter
engine/backend/orgtree/store.py - PostgreSQL adapter → PostgreSQL database: persists state
- Local engine API → V2 data import: offers import
engine/launch.py - V2 data import → Store interface: imports organizations