How deepagentlabs/agenticops-control-tower works
Control Tower is an early-stage, runtime-agnostic agent operations control plane. The implemented workflow is registration and heartbeat intake, in-memory inventory updates, then capability and status views through an API and CLI. The README also describes planned configuration, console, and MCP-facing operations; these are shown as planned or optional rather than implemented flows. Edges reflect sampled source or explicit README statements; unsampled subsystem wiring is not inferred.
Main entry points: surface.py Control API · status/service.py Status rollups · discovery/service.py Capability discovery · snapshot.py Snapshot loading
Components 14
Operator surfaces
Control plane
- Control API
src/agenticops_control_tower/api/surface.py - Agent registry
src/agenticops_control_tower/registry/service.py - Capability discovery
src/agenticops_control_tower/discovery/service.py - Status rollups
src/agenticops_control_tower/status/service.py - Snapshot loading
src/agenticops_control_tower/snapshot.py - Adapter catalog
src/agenticops_control_tower/adapters/catalog.py
Domain data
- Agent records
src/agenticops_control_tower/models/agent.py - Status and snapshot models
src/agenticops_control_tower/models/status.py
Planned capabilities
- Web console
src/agenticops_control_tower/console/app.py - Agentic MCP
- Configuration
src/agenticops_control_tower/config/models.py
Other components
- Human operator
Connections 16
- Human operator → CLI: operates through
README.md - CLI → HTTP API: calls
README.md - HTTP API → Control API: routes to
src/agenticops_control_tower/api/http.py - Control API → Agent registry: reads and writes
src/agenticops_control_tower/api/surface.py - Control API → Capability discovery: queries
src/agenticops_control_tower/api/surface.py - Control API → Status rollups: uses
src/agenticops_control_tower/api/surface.py - Status rollups → Capability discovery: aggregates
src/agenticops_control_tower/status/service.py - Snapshot loading → Control API: loads through
src/agenticops_control_tower/snapshot.py - Agent registry → Agent records: stores
src/agenticops_control_tower/registry/service.py - Capability discovery → Agent records: reads
src/agenticops_control_tower/discovery/service.py - Status rollups → Status and snapshot models: builds summaries
src/agenticops_control_tower/status/service.py - Snapshot loading → Status and snapshot models: validates snapshot
src/agenticops_control_tower/snapshot.py - Human operator → Web console: will operate through
README.md - Agentic MCP → Control API: planned interface
README.md - Control API → Configuration: planned management
README.md - Control API → Adapter catalog: potential discovery support