toolhive

Installer for the cmdop CLI — put an agent on a machine, then reach that machine from anywhere.

pip install toolhive
toolhive

That's it. toolhive detects your platform, downloads the cmdop binary, verifies it against the published checksums, installs it, and hands over.

Not affiliated with the ToolHive project. If you are looking for github.com/stacklok/toolhive, that is a different project — this package will not install it. This package is published by CMDOP and installs the cmdop CLI.

The hard part of running an agent somewhere is rarely starting it. It is getting back to it afterwards: the box is behind NAT, the tunnel expired, and the thing you actually wanted was a five-second question.

cmdop installs one binary that runs the agent and keeps the machine addressable. This package puts that binary on one machine; repeat it wherever you want reach.

How does CMDOP compare? CMDOP Skills vs OpenClaw: two approaches to AI agent skills →

Reachable is a property of the machine, not of the session

A shell session is something you open and lose. A machine in a fleet stays addressable between conversations, so asking it something tomorrow costs nothing you have to set up again.

Nothing is copied to a central place to make that work. Each machine keeps its own files, tools and credentials; the fleet is how you address them.

What is cmdop

One executable that is the agent, the relay, the local server and the web console at once. There is no gateway, backend, database server or broker to stand up — you add one binary to a machine you already own.

• run an AI agent on your own machine, with your own tools
• reach it from anywhere: terminal, files, remote execution
• connect machines into a fleet
• works with Claude Code and other agent engines under the hood

Full documentation: docs.cmdop.com

Usage

toolhive                    # install cmdop (if needed), then run it
toolhive --install-only     # install, don't hand over
toolhive --prefix ~/bin     # choose the install directory
toolhive --force            # reinstall even if already present
toolhive --quiet            # print only the installed path
toolhive -- --help          # everything after `--` goes to cmdop

Default install directory is ~/.local/bin (%LOCALAPPDATA%\cmdop\bin on Windows). No sudo, no system directories.

What it does, precisely

1. Detects your OS and architecture.
2. Fetches SHA256SUMS from install.cmdop.com.
3. Downloads the matching binary to a temporary file.
4. Verifies the SHA-256 against the published checksum. On mismatch it aborts and installs nothing.
5. Moves the verified binary into the install directory and marks it executable.
6. Runs it.

Supported: macOS (Apple Silicon, Intel), Linux (x64, arm64), Windows (x64).

What it does not do

• No side effects at install time. pip install toolhive only unpacks files. Nothing is downloaded or executed until you run toolhive.
• No network access on import. import toolhive touches nothing.
• No telemetry. The package sends no analytics, ever.
• No dependencies. Standard library only, so there is nothing to conflict with what you already have installed.

Python API

The installer is importable if you would rather script it:

import toolhive

target = toolhive.detect()
print(target.label, target.asset)

result = toolhive.install()
print(result.path, result.sha256)

toolhive.install() raises toolhive.InstallError with a user-facing message on any failure, and toolhive.UnsupportedPlatform when there is no published binary for the current machine.

Links

• Website — https://cmdop.com
• Documentation — https://docs.cmdop.com
• Downloads — https://cmdop.com/download

License

MIT