cmdop — the official SDK for CMDOP

Programmatic access to your CMDOP fleet from Python and Node — manage machines, fleets, tunnels, and schedules, stream a machine's AI agent live, and drive the skills marketplace, all behind one typed client.

Both clients ship in lockstep at the same version and expose the same surface — snake_case in Python, camelCase in Node.

📚 Full documentation: docs.cmdop.com — guides, the complete API reference, and streaming details. Product pages: SDK · Bots · Connect.

How it connects

Your app uses the SDK to reach your machines — any hardware, anywhere — through a CMDOP server you choose (the public cloud, or one you self-host in your own network). The server links your fleet over gRPC and hosts Jarvis, a built-in AI that can drive those machines on its own.

Why it's easy to adopt

• One install, zero dependencies. pip install cmdop / npm i @cmdop/sdk is everything — no native build step, no extra runtime, nothing fetched on first run.
• Works anywhere, offline-ready. A single self-contained package runs the same on macOS, Linux, and Windows, including air-gapped hosts.
• Typed end to end. Every resource and response is fully typed, with one clean async streaming API for live agent output.

Quick start

# pip install cmdop
from cmdop import Client

async with Client(token="...") as c:                 # or Client.from_env()
    page = await c.machines.list(presence="online")
    text = await c.machines.ask(machine_id, "uptime").collect()

// npm i @cmdop/sdk
import { Client } from "@cmdop/sdk";

const c = new Client({ token: "..." });              // or Client.fromEnv()
const page = await c.machines.list({ presence: "online" });
const text = await c.machines.ask(machineId, "uptime").collect();
await c.close();

What you can do

The headline feature is machines.ask() — stream a machine's AI agent as a clean async iterator of typed events. A connection PIN can be passed upfront (ask(…, pin="…"), the headless default) or answered reactively mid-stream, and dangerous plans surface as inline confirmation prompts.

Two planes, one client. machines / fleets / tunnels / schedules / keys use your relay token (CMDOP_TOKEN); the skills marketplace uses your platform API key (CMDOP_API_KEY). Set whichever you need — the client routes each call to the right plane.

Per-package docs

Full method reference, streaming details, environment variables, and error handling live in each package's README:

• Python → python/README.md
• Node → node/README.md

Links

• Docs → docs.cmdop.com
• SDK → cmdop.com/sdk · Bots → cmdop.com/bots · Connect → cmdop.com/connect
• cmdop on PyPI · @cmdop/sdk on npm
• CMDOP

License

MIT — see LICENSE.