sanerai

Installer for the cmdop CLI — run one AI agent that reaches every machine you own.

pip install sanerai
sanerai

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

Work is scattered across machines: a laptop, a build box, a server, something at home. Each one has its own tools and its own state, and the usual answer is to SSH into each in turn and remember which is which.

cmdop puts the same binary on each of them and connects them into a fleet. This package installs that binary on one machine; you repeat it wherever you want reach.

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

Machines join a fleet, not a dashboard

Each machine keeps its own tools, its own files, and its own credentials — the fleet is how you address them, not a place their data is copied to.

Adding the next machine is the same two commands as the first, which is what makes it worth doing for the fourth and fifth.

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

sanerai                    # install cmdop (if needed), then run it
sanerai --install-only     # install, don't hand over
sanerai --prefix ~/bin     # choose the install directory
sanerai --force            # reinstall even if already present
sanerai --quiet            # print only the installed path
sanerai -- --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 sanerai only unpacks files. Nothing is downloaded or executed until you run sanerai.
• No network access on import. import sanerai 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 sanerai

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

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

sanerai.install() raises sanerai.InstallError with a user-facing message on any failure, and sanerai.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