云结晶 CLI
用于管理的CLI 云纹 浏览器自动化工作流程并运行. 为编码代理设计,用于修复并编辑CloudCruise工作流程.
安装
npm install -g @cloudcruise/cli
设置
复制 .env.实例 改为 .env,然后运行 cloudcruise login。 。 。 .
编码代理集成
克劳德代码 从 repo 市场安装插件 :
/plugin marketplace add CloudCruise/cloudcruise-cli
/plugin install cloudcruise@cloudcruise
此记录所有六种技能( 工作流程构建、 测试、 调试、 CLI 和 DSL 引用) , 并用 /plugin update cloudcruise。 。 。 .
进取 —— org 管理员在显示于 设置 资源 插件 配置数字 :
{
"requiredPlugins": ["CloudCruise/cloudcruise-cli"]
}
从下个会话开始安装整个块; 使用 optionalPlugins 而不是让它选择进入。 德文读取 .claude-plugin/plugin.json 直接显示。 需要在您的 Devin org 上访问插件( 目前关闭的β -) 支持@ cognition.ai) (中文(简体) ).
其他代理( 或没有插件的 Claude 代码) ——直接安装技能文件:
cloudcruise install --skills # Claude Code + Cursor
cloudcruise install --skills --target claude # Claude Code only
cloudcruise install --skills --target cursor # Cursor only
保持最新状态
- CLI: 爱丽丝 当新版本存在时, CLI 通知您和您的编码代理。 更新方式
npm i -g @cloudcruise/cli@latest。 。 。 .CI财务报告和审定财务报表NO_UPDATE_NOTIFIER把支票关了. - 技能: cLI 升级后,下一个命令会刷新技能
cloudcruise install --skills写入当前工程。 将您编辑的技能单独保存;cloudcruise install --skills覆盖他们。 插件安装后的技能更新 .
关闭技能刷新,设置这个 ~/.cloudcruise/config.json数字 :
{ "settings": { "skillsAutoUpdate": false } }
CLOUDCRUISE_SKILLS_AUTO_UPDATE=0 或者说 =1 覆盖设置 。 随着新鲜度的降低,CLI警告 过时的技能代替.
快速启动
# List all workflows in your workspace
cloudcruise workflows list
# Get a workflow
cloudcruise workflows get <workflow_id> > workflow.json
# Start a run (returns { session_id } immediately; poll run get for completion)
cloudcruise run start <workflow_id>
# Start a debug run with snapshots on every node
cloudcruise run start <workflow_id> --debug
# Run the workflow but skip final submit/save actions (validates writes without submitting)
cloudcruise run start <workflow_id> --dry-run
# Start a run without workspace notifications (Slack/email) for this run
cloudcruise run start <workflow_id> --no-notifications
# Inspect a run (poll until the status is terminal)
cloudcruise run get <session_id>
# Update a workflow
cloudcruise workflows update <workflow_id> --file workflow.json --version-note "Fixed login selector"
用快照调试
之后a --debug 运行, 使用快照命令诊断失败 :
# Download HTML snapshot, screenshots, and metadata for a node
cloudcruise snapshot fetch <session_id> <node_id>
# Suggest unique XPath selectors for interactive elements
cloudcruise snapshot suggest <session_id> <node_id>
# Test an XPath selector against a snapshot
cloudcruise snapshot test '//button[@id="submit"]' <session_id> <node_id>
# Work with a local HTML file instead of fetching from the API
cloudcruise snapshot suggest --file ./snapshots/page.html
cloudcruise snapshot test '//input[@name="email"]' --file ./snapshots/page.html
所有命令
| 命令 | 说明 |
|---|---|
login | 浏览器 OAuth + PKCE 登录 |
logout | 删除活动配置文件的证书 |
whoami | 显示认证账户 |
auth login | 浏览器 OAuth + PKCE 登录 |
auth status | 检查认证( E)--profile(中文(简体) ) |
auth logout | 删除证书( E)--profile, (中文(简体) ), --all(中文(简体) ) |
auth switch <name> | 设置活动配置文件 |
auth profiles | 列出所有配置 |
auth workspace use <id> | 为配置设置活动的工作空间 |
workspaces list | 列出活动认证的工作空间 |
workspaces show | 显示配置文件的活动工作空间 |
workspaces use <id> | 为配置设置活动的工作空间 |
workspaces clear | 清除当前工作空间用于配置文件 |
workflows list | 清单工作流程(--full 详细情况, --folder <path> 范围到文件夹) |
workflows folders | 列表工作流程文件夹( E)--path 范围, --search(中文(简体) ) |
workflows get <id> | 获得工作流程定义( E)--version <version|range>, (中文(简体) ), --branch <name|id>· ; --version-number <n> 是最新遗产 n.x.x(中文(简体) ) |
workflows versions <id> | 列表工作流程版本历史 |
workflows update <id> | 更新工作流程--file, (中文(简体) ), --stdin, (中文(简体) ), --version-note, (中文(简体) ), --force, (中文(简体) ), --branch, (中文(简体) ), --release-version, (中文(简体) ), --bypass-protection);13号出口,如果尸体是 version_id 不再是最新的 |
workflows delete <id...> | 永久删除工作流程( 无确认); 打印每个 ID 的一个结果, 如果失败则退出非 0 |
branches list | 列出工作流程的分支; is_default 标记默认( e)--workflow(中文(简体) ) |
branches create <name> | 创建分支( E)--workflow, (中文(简体) ), --from <branch>, (中文(简体) ), --from-version <version>(中文(简体) ) |
branches delete <branch> | 删除一个非默认分支( E)--workflow, (中文(简体) ), --close-open-prs(中文(简体) ) |
branches set-default <branch> | 使分支为默认值( N)--workflow(中文(简体) ) |
prs list | 列表拉动请求( E)--workflow, (中文(简体) ), --state open|merged|closed|all(中文(简体) ) |
prs view <pr> | 显示拉动请求及其批准( E)--workflow(中文(简体) ) |
prs create | 打开拉动请求( E)--workflow, (中文(简体) ), --head, (中文(简体) ), --base, (中文(简体) ), --title(中文(简体) ) |
prs diff <pr> | 合并预览:与密钥和摘要相冲突, match_heads (单位:千美元)--merged, (中文(简体) ), --resolutions-template(中文(简体) ) |
prs approve <pr> | 批准拉动请求(不是你自己的) |
prs close <pr> | 关闭拉动请求 |
prs merge <pr> | 合并( E)--resolve <key>=source|target|delete, (中文(简体) ), --take, (中文(简体) ), --resolutions-file, (中文(简体) ), --match-heads, (中文(简体) ), --admin(中文(简体) ) |
components list | 列表工作流程组件--full(中文(简体) ) |
components get <id> | 获取组件( E)--version-number(中文(简体) ) |
components versions <id> | 列表组件版本--limit(中文(简体) ) |
components usage <id> | 使用此组件列出工作流程 |
components create | 创建组件( E)--name, (中文(简体) ), --file, (中文(简体) ), --stdin(中文(简体) ) |
components rename <id> | 重命名组件( N)--name(中文(简体) ) |
components update <id> | 更新组件--file, (中文(简体) ), --stdin, (中文(简体) ), --version-note, (中文(简体) ), --no-propagate, (中文(简体) ), --source-workflow-id(中文(简体) ) |
components delete <id> | 删除一个组件 |
error-codes list | 列出工作空间错误代码( L)--workflow-id(中文(简体) ) |
error-codes get <id> | 由 id 获取一个工作空间错误代码 |
error-codes create | 按名称查找或创建出错代码( N)--code, (中文(简体) ), --description, (中文(简体) ), --enriched-description, (中文(简体) ), --action,或通过 --file编号 :--stdin(中文(简体) ) |
error-codes update <id> | 更新错误代码( 与创建时的旗帜相同) |
run start <id> | 立即启动运行, 返回会话 id (--debug, (中文(简体) ), --input, (中文(简体) ), --version, (中文(简体) ), --branch <name|id>(中文(简体) ) |
run get <id> | 获取运行状态和结果( 翻到终端) |
run list | 列表运行( L)--workflow, (中文(简体) ), --status, (中文(简体) ), --limit, (中文(简体) ), --since(中文(简体) ) |
run interrupt <id> | 停止运行会话 |
run decision <id> | 显示恢复代理正在等待运行的决定( 需要的决定): 问题、 字段和选项, answer_by,在 agent.decision_requested 形状 |
run answer-decision <id> | 答复决定 要求回答回收代理在运行期间提出的问题(--decision-id, (中文(简体) ), --value <field=value>, (中文(简体) ), --text, (中文(简体) ), --directive(中文(简体) ) |
run respond <id> | 将用户交互数据提交正在等待的运行 USER_INTERACTION 节点( e)--data, (中文(简体) ), --file, (中文(简体) ), --stdin(中文(简体) ) |
run live-view <id> | 为活动会话获取新的活视图连接( 查看器 URL + 一次性验证符) |
run errors <id> | 分析错误( E)--since, (中文(简体) ), --limit(中文(简体) ) |
run snapshots <id> <node_id> | 获取调试快取元数据 |
run network <id> | 获取运行的全部记录网络流量( E)--include-noise, (中文(简体) ), --output(中文(简体) ) |
snapshot fetch <sid> <nid> | 下载 HTML 、 截图、 元数据 (--html, (中文(简体) ), --image(中文(简体) ) |
snapshot suggest [sid] [nid] | 推荐 XPath 选择者 (--file, (中文(简体) ), --filter(中文(简体) ) |
snapshot test <xpath> [sid] [nid] | 测试 XPath 与快照相对应 (--file, (中文(简体) ), --count(中文(简体) ) |
vault list | 列表金库条目( R)--full(中文(简体) ) |
vault get | 获取金库条目( E)--user-id, (中文(简体) ), --domain, (中文(简体) ), --decrypt; 额外的字段作为名称和类型,除非 --decrypt |
vault create | 创建金库条目( E)--user-id, (中文(简体) ), --domain, (中文(简体) ), --user-name, (中文(简体) ), --password, (中文(简体) ), --tfa-method (可重复), --additional-fields-file, (中文(简体) ), --security-questions-file, (中文(简体) ), --secret-provider-id, (中文(简体) ), --secret-ref(中文(简体) ) |
vault update | 更新金库条目字段,包括供应商支持的绑定; --no-tfa-method 删除每个 TFA 方法 |
vault tfa-code | 目前一个条目的2FA代码(--user-id, (中文(简体) ), --domain, (中文(简体) ), --method, (中文(简体) ), --field(中文(简体) ) |
vault clear-state | 清除证书的浏览器状态 |
vault encrypt 编号 : decrypt | 本地加密或解密值 |
secret-providers list | 列出秘密提供者连接 |
secret-providers items <provider-id> | 列出可见于秘密提供者连接的项目 |
builder start | 开始构建者对话( E)--start-url, (中文(简体) ), --name, (中文(简体) ), --vault-user-id(中文(简体) ) |
builder send <message> | 向构建者代理发送指令 |
builder respond | 对代理输入请求的答复(--message-id, (中文(简体) ), --value-stdin(中文(简体) ) |
builder status | 检查对话状态( N)/status 分类学 + 保存; 退出代码编码状态 0/7/8/9 |
builder conversations list | 列出工作空间的活构建者对话 |
builder conversations get [id] | 获取存档谈话记录, 直播或结束( L)--limit 尾声, 0 仅限元数据; --snapshot, (中文(简体) ), --include-system, (中文(简体) ), --output(中文(简体) ) |
builder workflow | 获取当前工作流程定义 |
builder messages | 获取对话历史( E)--limit, (中文(简体) ), --offset, (中文(简体) ), --no-tail(中文(简体) ) |
builder save | 数据库的长期工作流程(-m/--message 设置版本注释) |
builder interrupt | 停止代理处理 |
builder end | 结束谈话和清理 |
utils uuid | 生成节点ID的 UUID ()--count(中文(简体) ) |
install --skills | 为编码代理安装技能文件( E)--target(中文(简体) ) |
CLI 使用回转方向 http://127.0.0.1 在登录和在OS键链中存储可重复使用的证书时.
run list 默认为最近24小时 --since 省略。 使用诸如 24h, (中文(简体) ), 7d,或 30m 以调整时间窗口.
许可证
麻省理工学院