How anil-matcha/suparagent works
Suparagent is a workspace for AI coworkers: users configure agents and an engine, chat to delegate work, review gated actions, and use the resulting conversations and workspace files. The desktop shell can start the backend; the browser and phone clients provide additional ways to use the server. Major documented capabilities also include teams, memory, routines, connected apps, computers, tasks, skills, and templates. The graph combines README-described product flows with sampled engine and client evidence; unsampled subsystems are represented by their existing directories, and uncertain wiring is omitted.
Main entry points: thread_runtime.py Thread runtime · acp_adapter.py Engine adapters · agents.py Agents and teams · routine_service.py Routines
Components 22
Clients and access
- Desktop shell
desktop/main.js - Web workspace
frontend/app/chat/page.tsx - Phone app
mobile/src/app/thread/[id].tsx - API client
frontend/lib/api.ts - Engine settings
frontend/components/EngineSettings.tsx
Agent conversations
- Thread runtime
backend/app/services/thread_runtime.py - Engine adapters
backend/app/services/acp_adapter.py
Work coordination
- Agents and teams
backend/app/routers/agents.py - Agent memory
backend/app/services/memory_bridge.py - Approvals
backend/app/services/local_approval_broker.py - Agent computers
backend/app/computers/service.py - Routines
backend/app/services/routine_service.py - Tasks and planning
backend/app/services/work_planner.py - Connected apps
backend/app/services/composio_service.py - Skills and templates
backend/app/services/agent_skills.py - Workspace files
backend/app/services/workspace_files.py
Runtime and state
- Request authentication
backend/app/auth/middleware.py - Engine API
backend/app/routers/engines.py - Engine registry
backend/app/services/engine_registry.py - Conversation history
backend/app/services/thread_store.py - Application database
backend/app/db/engine.py
Other components
- User
Connections 21
- User → Desktop shell: opens workspace
README.md - User → Web workspace: starts chat
README.md - User → Phone app: pairs phone
README.md - Engine settings → API client: loads and saves
frontend/components/EngineSettings.tsx - Engine API → Engine registry: reads adapters
backend/app/routers/engines.py - Engine adapters → Conversation history: reads history
backend/app/services/acp_adapter.py - Engine adapters → Agent memory: uses memory bridge
backend/app/services/acp_adapter.py - Engine adapters → Approvals: uses approval broker
backend/app/services/acp_adapter.py - User → Agents and teams: creates agents
README.md - User → Approvals: reviews actions
README.md - User → Routines: schedules runs
README.md - User → Tasks and planning: plans tasks
README.md - User → Connected apps: connects tools
README.md - User → Skills and templates: reuses instructions
README.md - User → Workspace files: browses files
README.md - Agents and teams → Thread runtime: delegates work
- Thread runtime → Engine adapters: runs turns
- Thread runtime → Conversation history: persists conversations
- Thread runtime → Agent computers: uses computer tools
- Routines → Thread runtime: starts runs
- Agents and teams → Application database: stores agent state