Programmatic platform

Drive your whole fleetfrom code.

The cmdop SDK is the programmatic foundation the CLI and bots build on. One Go core owns the hard logic; thin typed clients for Python and Node just call it. Stream a machine’s AI agent, run fleets, open tunnels, schedule jobs — all from your own program.

Getting started View on GitHub

Two typed language clients connect through the CMDOP SDK core to fleet capabilities and remote machines

One product system

Start with one machine. Grow into a fleet.

Programmatic platform

CMDOP SDK for Python and Node machine automation

Drive your whole fleet from code with typed Python and Node clients for machine commands, agent-assisted tasks, streaming output, and bots.

How it connects

Your app to your machines,one connection.

Drive your whole fleet from code with typed Python and Node clients for machine commands, agent-assisted tasks, streaming output, and bots.

Install

One install. Nothing else.

Every platform ships baked inside one wheel and one npm package — no cmdop agent install, no notarization, no per-platform download. A runtime resolver picks the right build for the host at spawn time.

Python — PyPI

cmdop

Node — npm

@cmdop/sdk

cmdop 1.1.1 on PyPI · @cmdop/sdk 1.1.0 on npm

machines.ask()

Stream a machine’s agent,as a typed async iterator.

The headline op streams a machine’s AI agent through the relay, surfaced as a clean async iterator with live output, completion, errors and approval prompts.

Python

import asyncio
from cmdop import Client

async def main():
    async with Client() as client:  # API token from env
        stream = client.machines.ask(
            machine="work-mbp",
            prompt="What's eating disk on /var?",
        )
        async for frame in stream:
            if frame.kind == "event":
                print(frame.text, end="", flush=True)
            elif frame.kind == "done":
                break

asyncio.run(main())

Loading code…

Why it’s built this way

One core. Every language.

One Go core, thin typed clients

Auth, streaming, retries and error mapping are written once in Go and reused by every client. A new language is a thin typed shim — not a full port.

Baked-in binaries — no extra install

All five platform binaries ride inside one fat wheel and one npm package. End users just pip install or npm i — no cmdop agent, no optionalDependencies, no Gatekeeper notarization.

Two-plane client

Drive your whole fleet from code with typed Python and Node clients for machine commands, agent-assisted tasks, streaming output, and bots.

machines.ask() streaming

Stream a machine’s AI agent as a typed async iterator, with approval prompts when work needs confirmation. The same interaction model as the app, now scriptable.

Bots built in

Telegram, Discord and Slack bots are now hosted entirely inside the SDK core. Start one with client.bots.run(...) and the Go binary runs the channel loop, driving machines.ask() per message. The SDK absorbed bots.

The surface

Typed namespacesover your whole fleet.

Every relay op is mirrored in both clients and gated by a cross-language parity check — a method in one language but not the other fails CI.

Why it’s built this way

machineslist · get · info · spend · ask · messages · active_session

fleetscrud · members · attach · detach

tunnelsopen · close · list · get · sessions

schedulescrud · trigger · runs

keyslist · issue · revoke

Learn more

skillslist · install · publish

botsrun · management (Telegram · Discord · Slack)

Learn more

Read the docs.Ship in minutes.

Full reference for every namespace, the streaming model, and error handling.

Getting started View on GitHub

Build on the foundation.

The programmatic core every other cmdop product is built on. Install it, import it, ship.

Get the SDK SDK docs