How imbue-ai/mngr works
mngr is a Unix-style CLI for creating, managing, and connecting to coding agents across local and remote hosts. The main workflow is a user invoking CLI commands, which load the plugin system and operate on agents through provider-backed compute; users can then connect, message, transfer work, or snapshot and clone agent state. The repository also includes an SSH-forwarding plugin and provider implementations. Edges are limited to relationships stated in the README or visible in the supplied source index and excerpts; unsampled internals are not assumed.
Main entry points: mngr Agent Lifecycle · vps_client.py VPS Provisioning · main.py mngr CLI · server.py Forward Server
Components 18
CLI and Plugins
- mngr CLI
libs/mngr/imbue/mngr/main.py - Plugin Manager
libs/mngr/imbue/mngr/cli/plugin_manager.py - CLI Commands
libs/mngr/imbue/mngr/cli
Agent Operations
- Agent Lifecycle
libs/mngr/imbue/mngr - Agent Plugins
libs/mngr_claude/imbue/mngr_claude/plugin.py - Codex Client
libs/mngr_codex/imbue/mngr_codex/app_server_client.py - Auto-compact
libs/mngr_autocompact/imbue/mngr_autocompact/manager.py
Compute Providers
- VPS Provisioning
libs/mngr_vps/imbue/mngr_vps/vps_client.py - AWS Provider
libs/mngr_aws/imbue/mngr_aws/client.py - Azure Provider
libs/mngr_azure/imbue/mngr_azure/client.py - GCP Provider
libs/mngr_gcp/imbue/mngr_gcp/client.py - Imbue Cloud
libs/mngr_imbue_cloud/imbue/mngr_imbue_cloud/connector/client.py
Remote Access
- Forward Server
libs/mngr_forward/imbue/mngr_forward/server.py - Agent Event Streams
libs/mngr_forward/imbue/mngr_forward/stream_manager.py - SSH Tunnels
libs/mngr_forward/imbue/mngr_forward/ssh_tunnel.py
Other components
- User
- Agent Hosts
- Coding Agent
Connections 18
- User → mngr CLI: runs commands
- mngr CLI → CLI Commands: dispatches to
libs/mngr/imbue/mngr/main.py - mngr CLI → Plugin Manager: loads plugins
libs/mngr/imbue/mngr/main.py - Plugin Manager → Agent Plugins: loads agent plugins
libs/mngr/imbue/mngr/cli/plugin_manager.py - CLI Commands → Agent Lifecycle: manages agents
libs/mngr/imbue/mngr/cli/plugin_manager.py - Agent Lifecycle → Agent Hosts: runs on
- Agent Lifecycle → Coding Agent: starts and manages
- Agent Plugins → Coding Agent: integrates agent
- Auto-compact → Agent Lifecycle: integrates with
libs/mngr_autocompact/imbue/mngr_autocompact/manager.py - Agent Hosts → VPS Provisioning: provisioned by
- AWS Provider → VPS Provisioning: implements client
libs/mngr_aws/imbue/mngr_aws/client.py - Azure Provider → VPS Provisioning: implements client
libs/mngr_azure/imbue/mngr_azure/client.py - GCP Provider → VPS Provisioning: implements client
libs/mngr_gcp/imbue/mngr_gcp/client.py - Imbue Cloud → Agent Hosts: provides compute
- User → Forward Server: connects remotely
- Forward Server → Agent Event Streams: manages streams
libs/mngr_forward/imbue/mngr_forward/server.py - Forward Server → SSH Tunnels: uses tunnels
libs/mngr_forward/imbue/mngr_forward/server.py - Agent Event Streams → Agent Lifecycle: observes agents
libs/mngr_forward/imbue/mngr_forward/stream_manager.py