How linyeping/metis works
Metis is a local AI workbench for Chat, Cowork, Code, and Design. The main task flow is to establish project and session context, run an agent task through model and tool integrations, review changes, verify outcomes, and retain results for recovery. The desktop renderer and Python Flask/SSE backend form the primary interface and execution layers; runtime management and the separate Design surface support additional workflows. Some subsystems are represented from README capabilities and the file tree rather than inspected implementation, so uncertain connections are omitted or marked unverified.
Main entry points: agent_loop.py Agent Loop · App.tsx Workbench App · session_routes.py Session Routes · api.ts HTTP API Client
Components 23
Desktop Workbench
- Workbench App
desktop/src/App.tsx - HTTP API Client
desktop/src/lib/api.ts - Run State
desktop/src/store/runManager.ts - Desktop Host
desktop/electron/main.cjs
Agent Backend
- Flask API
backend/web/app.py - Session Routes
backend/web/session_routes.py - Session Workspace
backend/web/sessions.py - Agent Services
backend/runtime/agent_services.py - Agent Loop
backend/runtime/agent_loop.py - Cowork Coordinator
backend/runtime/cowork_coordinator.py - Model Backends
backend/runtime/llm_backends/_common.py - Workspace Routes
backend/web/workspace_routes.py
Execution and Tools
- Tool Registry
backend/runtime/tool_registry.py - Agent Tools
backend/tools/registry.py - Permission Control
backend/runtime/permission_control.py - Worktree Manager
backend/runtime/worktree_manager.py - Runtime Manager
backend/runtime/runtime_manager.py - Connectors and MCP
backend/runtime/connectors/manager.py
Design Surface
- Design Studio
desktop/src/components/design/DesignSurface.tsx - Design Runtime Host
desktop/electron/design-renderer-service.cjs - Design Project Routes
open-design/apps/daemon/src/import-export-routes.ts - Project Storage
open-design/apps/daemon/src/storage/project-storage.ts
Other components
- User
Connections 22
- User → Workbench App: uses
README.md - Workbench App → HTTP API Client: requests
desktop/src/App.tsx - Workbench App → Design Studio: renders
desktop/src/App.tsx - Workbench App → Desktop Host: connects through
- HTTP API Client → Flask API: HTTP and SSE
- HTTP API Client → Run State: updates
- Flask API → Session Routes: routes
- Session Routes → Session Workspace: uses
backend/web/sessions.py - Session Routes → Agent Services: invokes
backend/web/session_routes.py - Agent Services → Agent Loop: runs
- Agent Loop → Model Backends: queries
- Agent Loop → Tool Registry: dispatches
- Tool Registry → Agent Tools: registers
- Agent Loop → Permission Control: checks
- Session Routes → Cowork Coordinator: coordinates
- Workspace Routes → Cowork Coordinator: coordinates
backend/web/workspace_routes.py - Workspace Routes → Worktree Manager: manages
backend/web/workspace_routes.py - Agent Loop → Connectors and MCP: uses
- Agent Loop → Runtime Manager: uses
- Design Studio → Design Runtime Host: previews through
- Design Runtime Host → Design Project Routes: serves
- Design Project Routes → Project Storage: persists