How godiao/dreamcoder works
DreamCoder is a local AI coding workbench: users configure a model provider, work in a desktop session, and inspect assistant output, tool calls, file changes, and terminal activity. The core runtime coordinates model turns and tools while retaining session state. Documented extensions include LAN browser access and MCP tools; IM adapters are present in the tree but the README describes them as roadmap work. The source excerpts show selected runtime relationships; several desktop-to-runtime links are inferred and marked unverified.
Main entry points: QueryEngine.ts Turn Engine · App.tsx Desktop UI · sessions.ts Session API · Tool.ts Tool Dispatch
Components 20
Desktop Workbench
- Desktop UI
desktop/src/App.tsx - Session Chat
desktop/src/pages/ActiveSession.tsx - Provider Settings
desktop/src/components/settings/ProviderSettings.tsx - Desktop API
desktop/src/api/client.ts - Session API
desktop/src/api/sessions.ts - Permission UI
src/components/permissions/FilePermissionDialog/usePermissionHandler.ts - Integrated Terminal
desktop/src/components/workspace/WorkspacePanel.tsx
Agent Runtime
- Turn Engine
src/QueryEngine.ts - Query Loop
src/query.ts - Tool Dispatch
src/Tool.ts - Commands
src/commands.ts
Session State
- Runtime State
src/bootstrap/state.ts - Session Storage
src/utils/sessionStorage.ts - Tool Results
src/utils/toolResultStorage.ts
External Access
- LAN Browser
desktop/src/components/layout/H5ConnectionView.tsx - MCP Manager
src/services/mcp/MCPConnectionManager.tsx - MCP Services
- Model Provider
Other components
- Developer
- Phone Browser
Connections 19
- Developer → Desktop UI: uses
README.md - Desktop UI → Session Chat: opens session
- Provider Settings → Model Provider: configures
README.md - Session Chat → Session API: requests session
- Session API → Desktop API: uses
- Session API → Turn Engine: starts turns
- Turn Engine → Query Loop: runs loop
src/QueryEngine.ts - Turn Engine → Commands: loads commands
src/QueryEngine.ts - Query Loop → Tool Dispatch: dispatches
- Turn Engine → Runtime State: reads state
src/QueryEngine.ts - Turn Engine → Session Storage: flushes
src/QueryEngine.ts - Tool Dispatch → Tool Results: stores results
src/Tool.ts - Tool Dispatch → Permission UI: requests approval
src/components/permissions/FilePermissionDialog/usePermissionHandler.ts - Turn Engine → Model Provider: sends turns
- Turn Engine → MCP Manager: uses tools
- MCP Manager → MCP Services: connects
README.md - Phone Browser → LAN Browser: connects over LAN
README.md - LAN Browser → Desktop UI: continues sessions
README.md - Desktop UI → Integrated Terminal: embeds
README.md