How yuezhihuafou/devspace-verge works
DevSpace Verge exposes configured local coding workspaces to coding agents through an MCP server and companion workspace UI. The main flow is an agent opening a workspace, invoking tools for code/process/Git work, then retrieving bounded results or reviewing changes. Durable tasks and run logs support detached work and later inspection; semantic navigation and local-agent integrations add separate capabilities. The server excerpt establishes orchestration and selected dependencies; README documents the broader feature set, but unsampled tool implementations and wiring are not inferred.
Main entry points: server.ts MCP server · run-store.ts Run storage · local-agent-manager.ts Local-agent manager · workspace-app.tsx Workspace UI
Components 24
Agent Interface
- MCP server
src/server.ts - Tool surfaces
src/tool-surfaces/index.ts - Workspace UI
src/ui/workspace-app.tsx
Workspace Operations
- Workspace registry
src/workspaces.ts - Configuration
src/config.ts - Process sessions
src/process-sessions.ts - Git operations
src/git.ts - Git worktrees
src/git-worktrees.ts - Patch handling
src/apply-patch.ts - Semantic navigation
src/serena-semantic.ts
Long-Running Work
- Durable task manager
src/durable-tasks.ts - Run log access
src/compact-runtime/run-log-access.ts - Run storage
src/compact-runtime/run-store.ts - Log retention
src/compact-runtime/retention.ts
Local Agents
- Local-agent manager
src/local-agent-manager.ts - Daemon client
src/local-agent-client.ts - Agent daemon
src/local-agent-daemon.ts - Agent adapters
src/local-agent-adapters.ts
Persistence and Review
- SQLite database
src/db/client.ts - Workspace state
src/workspace-store.ts - Review checkpoints
src/review-checkpoints.ts
Other components
- Coding agent
- Git
- Serena / LSP
Connections 26
- Coding agent → MCP server: sends MCP requests
- MCP server → Tool surfaces: selects tools
- MCP server → Configuration: loads settings
- MCP server → Workspace registry: serves workspace tools
- MCP server → Process sessions: manages sessions
- MCP server → Durable task manager: manages tasks
- MCP server → Semantic navigation: creates manager
- MCP server → Review checkpoints: creates manager
- MCP server → Local-agent manager: builds provider status
- MCP server → Workspace UI: provides app results
- MCP server → Run log access: reads run results
- Process sessions → Run storage: stores run output
- Durable task manager → Run storage: uses run storage
- Run log access → Run storage: locates runs
- Log retention → Run storage: prunes stored runs
- MCP server → Git worktrees: manages worktrees
- MCP server → Patch handling: applies patches
- Semantic navigation → Serena / LSP: queries semantics
- Review checkpoints → Git operations: reads and updates refs
- Git operations → Git: executes Git
- Local-agent manager → Daemon client: runs through daemon
- Daemon client → Agent daemon: sends protocol requests
- Agent daemon → Agent adapters: dispatches provider work
- Local-agent manager → SQLite database: persists agent records
- Workspace registry → Workspace state: persists workspace state
- Workspace UI → Coding agent: renders tool cards