systems-manager

A cross-platform CLI, API, MCP Server, and Agent for system maintenance, package management, and zero-script remote host orchestration 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).
• Zero-script remote orchestration — telemetry and control across an inventory of hosts over plain SSH, with no remote daemons or packages deployed on the targets.

Explore the documentation

• Installation — pip, source, extras, and the prebuilt Docker image.
• Deployment — run the MCP and agent servers, Docker Compose, Caddy + Technitium.
• 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 — zero-script remote telemetry and control plane.
• 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 the full matrix (PyPI extras, Docker image, all transports, reverse proxy, DNS, and the agent server).