agent-device

agent-device

Installer for the cmdop CLI — one binary per device, one place to talk to all of them.

pip install agent-device
agent-device

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

Not affiliated with the agent-device project. If you are looking for [github.com/callstack/agent-device](https://github.com/callstack/agent- device), that is a different project — this package will not install it. This package is published by CMDOP and installs the cmdop CLI.

The machines worth automating are rarely the one in front of you. They are the build box, the server in the cupboard, the always-on thing that actually runs the job — and each needs its own way in.

cmdop gives each of them the same one: install the binary, and the device becomes something you can address. This package installs it.

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

A device you can address is worth more than a device you can log into

Logging in is a session you open and close. Being addressable is a property the machine keeps, so tomorrow's question does not start with re-establishing a connection.

Each device keeps its own tools and credentials. Nothing is centralised to make it reachable — the fleet is an addressing scheme, not a place data goes.

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

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

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

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

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