cmdop 2026.3.18

Python SDK for CMDOP agent interaction

CMDOP

Your OS. Online.

Full access to your machines from anywhere. Not files — the whole system.

Your Code ──── Cloud Relay ──── Agent (on server)
                   │
       Outbound only, works through any NAT/firewall

Install

pip install cmdop

Quick Start

from cmdop import AsyncCMDOPClient

async with AsyncCMDOPClient.remote(api_key="cmdop_xxx") as client:
    # Terminal
    await client.terminal.set_machine("my-server")
    output, code = await client.terminal.execute("uname -a")

    # Files
    content = await client.files.read("/etc/hostname")
    await client.files.write("/tmp/config.json", b'{"key": "value"}')

    # AI Agent with typed output
    from pydantic import BaseModel

    class Health(BaseModel):
        cpu: float
        memory: float
        issues: list[str]

    await client.agent.set_machine("my-server")
    result = await client.agent.run("Check server health", output_model=Health)
    health: Health = result.data  # Typed!

    # Skills — run predefined AI workflows
    await client.skills.set_machine("my-server")
    skills = await client.skills.list()
    result = await client.skills.run("code-review", "Review the auth module")

Connection

from cmdop import CMDOPClient, AsyncCMDOPClient

# Remote (via cloud relay) - works through any NAT
client = CMDOPClient.remote(api_key="cmdop_xxx")

# Local (direct IPC to running agent)
client = CMDOPClient.local()

# Async
async with AsyncCMDOPClient.remote(api_key="cmdop_xxx") as client:
    ...

Documentation

Topic	Description
Terminal	Execute commands, stream output, SSH sessions
Auth	Agent password authentication, session tokens
Files	Read, write, list files on remote machines
Agent	AI tasks with structured typed output
Skills	Predefined AI workflows with tool access
Download	Download files from URLs via remote server
SDKBaseModel	Auto-cleaning Pydantic model for scraped data

Architecture

┌─────────────┐    gRPC/HTTP2    ┌─────────────┐    gRPC    ┌─────────┐
│   Python    │◀────────────────▶│   Cloud     │◀──────────▶│  Agent  │
│     SDK     │   Bidirectional  │   Relay     │  Outbound  │  (Go)   │
└─────────────┘                  └─────────────┘            └─────────┘

• Agent makes outbound connection (no port forwarding)
• SDK connects via gRPC (works through any firewall)
• All services multiplexed over single connection

Comparison

Feature	CMDOP	Tailscale	ngrok	SSH
Terminal streaming	gRPC	VPN + SSH	No	Yes
File operations	Built-in	SFTP	No	SCP
AI agent	Built-in	No	No	No
Reusable AI skills	Built-in	No	No	No
NAT traversal	Outbound	WireGuard	Outbound	Port forward
Client install	None	VPN client	None	SSH client
Structured output	Pydantic	No	No	No

Requirements

• Python 3.10+
• CMDOP agent running locally or API key for remote access

Links

• Examples
• Documentation
• Bot Documentation
• Skills Catalog
• Agent Download
• GitHub