可编程平台

从代码驱动你的整个机群。

cmdop SDK 是 CLI 和机器人构建于其上的可编程基础。一个 Go 核心承担艰难的逻辑；为 Python 和 Node 提供的轻量类型化客户端只需调用它。流式传输一台机器的 AI 代理、运行机群、打开隧道、调度任务——全部从你自己的程序中完成。

Getting started cmdop @cmdop/node View on GitHub

可编程平台

sdk.diagram.eyebrow

sdk.diagram.title

sdk.diagram.body

安装

一次安装。别无他物。

全部五个平台二进制文件都内置于一个 fat wheel 和一个 npm 包中发布——无需安装 cmdop 代理、无需公证、无需按平台下载。运行时解析器在 spawn 时挑选主机的二进制文件。

Python — PyPI

cmdop

Node — npm

@cmdop/node

cmdop 1.0.0 on PyPI · @cmdop/sdk 1.0.0 on npm

machines.ask()

流式传输一台机器的代理，作为一个类型化的异步迭代器。

这个主力操作通过 relay 向一台机器的 AI 代理打开一个 SSE 流，以类型化帧的简洁异步迭代器形式呈现——event、done、error、confirm_required、pin_required、pin_denied——并带有流中途的 pin 和 confirm 侧信道。

Python

import asyncio
from cmdop import Client

async def main():
    async with Client() as client:  # CMDOP_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 == "confirm_required":
                await stream.confirm(frame.id, allow=True)
            elif frame.kind == "pin_required":
                await stream.pin(frame.id, code="0492")
            elif frame.kind == "done":
                break

asyncio.run(main())

Loading code...

为何这样构建

一个核心。每一种语言。

一个 Go 核心，轻量类型化客户端

认证、relay 的 SSE 流、重试和错误映射在 Go 中只编写一次，并被每个客户端复用。一种新语言只是一个约 400 行的轻量垫片外加一个生成的类型化表层——而非一次完整移植。

内置二进制——无需额外安装

全部五个平台二进制文件都随一个 fat wheel 和一个 npm 包一同携带。最终用户只需 pip install 或 npm i——无需 cmdop 代理、无需 optionalDependencies、无需 Gatekeeper 公证。

双平面客户端

机器、机群、隧道、调度和密钥使用你的 CMDOP_TOKEN 发往 relay。Skills 和机器人使用你的 UserAPIKey 发往平台。一个客户端，两个凭证，出于设计。

machines.ask() SSE 流式传输

将一台机器的 AI 代理作为类型化异步迭代器流式传输，并带有流中途的 pin 和 confirm 侧信道。与应用相同的交互模型，如今可脚本化。

内置机器人

Telegram、Discord 和 Slack 机器人现在完全托管在 SDK 核心之内。用 client.bots.run(...) 启动一个，Go 二进制就会运行频道循环，按每条消息驱动 machines.ask()。SDK 吸收了机器人。

表层

类型化命名空间覆盖你的整个机群。

每个 relay 操作都在两个客户端中镜像，并受跨语言一致性检查的把关——某方法在一种语言中存在而在另一种中不存在，CI 就会失败。

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

Relay 平面 · CMDOP_TOKEN

fleetscrud · members · attach · detach

Relay 平面 · CMDOP_TOKEN

tunnelsopen · close · list · get · sessions

Relay 平面 · CMDOP_TOKEN

schedulescrud · trigger · runs

Relay 平面 · CMDOP_TOKEN

keyslist · issue · revoke

Relay 平面 · CMDOP_TOKEN

skillslist · install · publish

平台平面 · UserAPIKey

botsrun · management (Telegram · Discord · Slack)

平台平面 · UserAPIKey

了解更多

阅读文档。数分钟内发布。

每个命名空间、流式模型和错误处理的完整参考。

Getting started Machines Streaming Fleets Errors View on GitHub

在基础之上构建。

其他每一个 cmdop 产品所构建于其上的可编程核心。安装它，导入它，发布。

获取 SDK SDK 文档