systems-manager

A cross-platform CLI, API, MCP Server, and Agent for system maintenance, package management, and governed fleet delegation in the agent-utilities ecosystem.

Official documentation

This site is the canonical reference for systems-manager, maintained alongside every release.

Overview

systems-manager updates the host operating system, installs and upgrades applications, and exposes those same capabilities to AI agents through a typed, deterministic MCP tool surface. It provides:

• A cross-distribution package manager — one façade (SystemsManagerBase) over apt, dnf, zypper, pacman, and Windows, selected automatically per host.
• Action-routed MCP tools — consolidated, togglable tool modules for system, service, process, network, disk, user, file, cron, and firewall operations.
• An integrated Pydantic AI graph agent — reachable over the Agent Control Protocol (ACP) and the Agent Web UI (AG-UI).
• Fleet composition — GraphOS can delegate to authenticated per-host services or compose host-key-verified tunnel-manager capabilities.

Explore the documentation

• Installation — pip, source, extras, and the prebuilt Docker image.
• Deployment — run authenticated MCP and agent services with verified TLS.
• Usage — the MCP tools, the SystemsManager API, and the CLI.
• Overview — ecosystem role and the concept map.
• Sudo Security — the least-privilege elevated-execution model.
• Multi-Host — governed fleet delegation.
• Day 0 Provisioning — bare-metal to managed cluster node.

Quick start

pip install "systems-manager[mcp]"
systems-manager-mcp              # stdio MCP server (default transport)

Run the package-management CLI directly:

systems-manager --update --install "git,curl,htop"

See Installation and Deployment for package extras, supported transports, container boundaries, and the agent server.