How gabrielpmares/lago-agents works
Lago Agents is a control hub for people steering teams of AI coding agents. In the desktop workflow, a person uses the app to review work and issue requests; the API exposes app actions, while Lago’s orchestration and team runtime coordinate agent work and record its state. The hub database, configuration, activity log, and transcripts support status and history. The README also documents live task maps, terminals, file activity, replay, and optional voice and phone access. Backend relationships are grounded in the source index and excerpts; several documented or unsampled capabilities have no asserted internal wiring.
Main entry points: api.py App API · team.py Team runtime · LagoClient.kt Paired server client · open_tasks.py Open run status
Components 22
User experience
- Desktop app
lago/desktop.py - App API
lago/api.py
Agent orchestration
- Lago assistant tools
lago/lago_mcp.py - Team runtime
lago/team.py - Agent runner
lago/runner.py - Open run status
lago/open_tasks.py
Shared state and history
- Configuration
lago/config_store.py - Shared work database
lago/hub.py - Activity and search
lago/activity.py - Run transcripts
lago/transcripts.py
Product capabilities
- Accounts and usage
lago/accounts.py - Agent evaluations
lago/evals.py - Live terminals
- Live map and replay
lago/ui/app.js - Voice features
lago/voice.py - External connectors
lago/connectors.py
Android companion
- Android app
android/app/src/main/java/com/lagoagents/mobile/MainActivity.kt - Paired server client
android/app/src/main/java/com/lagoagents/mobile/net/LagoClient.kt - Phone calls
android/app/src/main/java/com/lagoagents/mobile/call/CallService.kt - Live alerts
android/app/src/main/java/com/lagoagents/mobile/alerts/LiveAlertsService.kt - App updater
android/app/src/main/java/com/lagoagents/mobile/update/Updater.kt
Other components
- Person
Connections 24
- Person → Desktop app: steers work
- Desktop app → App API: invokes actions
lago/api.py - App API → Team runtime: dispatches work
lago/api.py - App API → Lago assistant tools: invokes tools
lago/api.py - Team runtime → Agent runner: runs agents
lago/team.py - Team runtime → Shared work database: records work
lago/team.py - Team runtime → Configuration: loads settings
lago/team.py - Agent runner → Configuration: loads settings
lago/runner.py - Open run status → Agent runner: checks running
lago/open_tasks.py - Open run status → Shared work database: reads tasks
lago/open_tasks.py - Open run status → Run transcripts: reads last words
lago/open_tasks.py - Activity and search → Shared work database: stores activity
lago/activity.py - App API → Activity and search: serves activity
lago/api.py - App API → Accounts and usage: serves account data
lago/api.py - App API → Agent evaluations: serves evaluations
lago/api.py - Person → Live map and replay: reviews work
- Person → Live terminals: watches terminals
- Person → Voice features: talks to Lago
- Person → External connectors: uses integrations
- Person → Android app: uses phone app
- Android app → Paired server client: sends requests
- Phone calls → Paired server client: starts calls
android/app/src/main/java/com/lagoagents/mobile/call/CallService.kt - Live alerts → Paired server client: opens live connection
- App updater → Paired server client: checks and downloads
android/app/src/main/java/com/lagoagents/mobile/update/Updater.kt