How cristicretu/diri works
Diri is a native desktop workspace for running and coordinating coding agents across local and SSH-hosted machines, with isolated worktrees, persistent sessions, and in-context review. The main workflow is to launch an agent session, keep its terminal alive independently of the app, monitor its status, and review resulting changes. The README also documents agent-to-agent delegation and a phone companion. The graph emphasizes these product paths; source excerpts reveal holder internals, but most UI, orchestration, and remote wiring is unsampled, so those links are documented or left unverified.
Main entry points: control.rs Session control · workspace_workbench.rs Workspace UI · server.rs Session holder · main.rs Desktop app
Components 22
Desktop experience
- Desktop app
diri/crates/diri-app/src/main.rs - Workspace UI
diri/crates/diri-app/src/workspace_workbench.rs - Agent catalog
diri/crates/diri-app/src/agent_catalog.rs - Terminal pane
diri/crates/diri-app/src/terminal_pane/controller.rs - Usage dashboard
diri/crates/diri-usage/src/transcripts/dashboard.rs
Session engine
- Engine daemon
diri/crates/diri-engine/src/lib.rs - Session control
diri/crates/diri-engine/src/control.rs - Worktree management
diri/crates/diri-engine/src/worktree_scan.rs - Agent CLI process
diri/crates/diri-engine/src/pty.rs - Holder manager
diri/crates/diri-engine/src/holder/manager.rs - Session holder
diri/crates/diri-engine/src/holder/server.rs - Holder protocol
diri/crates/diri-engine/src/holder/protocol.rs - Output log
diri/crates/diri-engine/src/holder/log_feed.rs
Remote and phone
- Remote manager
diri/crates/diri-engine/src/remote/manager.rs - Phone web gateway
diri/crates/diri-web/src/api.rs - Diri phone app
ios/DiriPhone/Net/AppModel.swift
Coordination and review
- Change review
diri/crates/diri-app/src/git_review.rs - Notes and tasks
diri/crates/diri-notes/src/doc.rs - Agent MCP tools
diri/crates/dirijor-mcp/src/bridge/tasks.rs
Other components
- User
- SSH host
- Agent CLI
Connections 23
- User → Desktop app: opens
README.md - Desktop app → Workspace UI: presents
- Workspace UI → Agent catalog: offers agents
- Workspace UI → Session control: requests sessions
- Workspace UI → Worktree management: assigns worktrees
README.md - Session control → Holder manager: launches holders
- Holder manager → Session holder: hosts sessions
diri/crates/diri-engine/src/holder/manager.rs - Session holder → Agent CLI process: owns PTY
diri/crates/diri-engine/src/holder/server.rs - Session holder → Holder protocol: serves requests
diri/crates/diri-engine/src/holder/server.rs - Session holder → Output log: writes output
diri/crates/diri-engine/src/holder/server.rs - Terminal pane → Session control: attaches session
- Terminal pane → Output log: reads output
- Agent CLI process → Agent CLI: runs CLI
README.md - User → Change review: reviews changes
README.md - Change review → Worktree management: reviews worktree
README.md - User → Notes and tasks: plans tasks
README.md - Agent MCP tools → Session control: coordinates agents
README.md - Session control → Remote manager: manages remote
- Remote manager → SSH host: runs helper
diri/crates/diri-engine/src/remote/manager.rs - User → Diri phone app: monitors remotely
README.md - Diri phone app → Phone web gateway: calls HTTP API
- Phone web gateway → Session control: controls sessions
- Desktop app → Usage dashboard: shows usage
diri/crates/diri-app/src/main.rs