agentdesktop documentation
Manage AI developer tools across your fleet.
Discover installed tools, inventory MCP servers and skills, reconcile managed configuration, and connect devices to an inference gateway.
Project overview
agentdesktop is an open-source control plane for AI developer tools. A daemon on each device discovers installed tools and reconciles their configuration. It can read desired configuration from a local YAML file or receive it from the agentdesktop controller.
agentdesktop can:
- Report installed developer tools and versions.
- Inventory configured MCP servers and agent skills.
- Reconcile managed settings and a shared inference gateway.
- Enroll a device and associate it with the signed-in user.
- Supply short-lived gateway credentials to configured tools.
- Report selected session and tool-use events when telemetry is enabled.
Supported tools
| Tool | Discovery | Managed configuration | MCP and skills |
|---|---|---|---|
| Claude Code | Yes | Yes | MCP and skills |
| Claude Desktop | Yes | Yes | MCP |
| Codex | Yes | Yes | MCP and skills |
| OpenCode | Yes | Yes | MCP |
| VS Code | Yes | Not yet | Not yet |
The project targets Linux, macOS, and Windows. Some managed settings require system-level access; Claude Desktop configuration, for example, cannot be applied in --user mode.
Data boundaries
Discovery is designed to avoid collecting secrets. MCP command arguments, environment variables, and HTTP headers are omitted. Skill bodies are omitted; agentdesktop records their path and YAML front matter.
Telemetry is off until event names are configured. Current hooks can report new Claude sessions and tool use. Tool input is collected only when tool.use.input is selected, and hook failures do not block the developer tool.
Components
| Component | Owns |
|---|---|
| Device daemon | Discovery, local API, configuration reconciliation, enrollment, gateway credential helpers, and telemetry collection |
| Desktop app | Local daemon status, configuration state, and enrollment status |
| Controller | OIDC enrollment, device certificates, configuration distribution, inventory, telemetry, gateway JWTs, and the fleet management UI |
| Inference gateway | External model endpoint configured in developer tools; Agentgateway is used by the repository examples |
Developer tools connect directly to the configured inference gateway. The daemon writes the gateway URL into supported tool configuration and supplies credentials through each tool’s helper mechanism; it does not proxy model traffic.
Quickstart
Choose where agentdesktop gets its configuration.
Read configuration from local YAML
Run without a controller or device identity and authenticate directly to your inference gateway with OIDC.
→ Controller-managedDistribute configuration across a fleet
Enroll devices, issue short-lived gateway credentials, and inspect inventory and selected events.
→Contributing
Build and test agentdesktop.
Run the Rust and frontend checks and find the crates that own discovery, reconciliation, enrollment, and fleet management.