CLI 命令速查

Multiflow CLI 的所有顶级命令一页概览。完整用法查 `multiflow <命令> --help`。

Multiflow CLI 把 Web UI 能做的事几乎全部搬到了命令行上（创建 issue、分配智能体、启动守护进程等等）。这一页把所有顶级命令列出来，每条配一句用途。完整 flag 和示例用 multiflow <命令> --help 查。

认证入口

第一次用 CLI 时先登录，拿一个个人访问令牌（Personal Access Token，PAT）：

multiflow login

浏览器会自动打开，你在 Web 端同意后，CLI 把 PAT（mul_ 前缀）保存到 ~/.multica/config.json。此后所有命令都会自动用这个 PAT 认证。

CI / 无浏览器环境跳过浏览器流程：先在 Web 端 Settings → Personal Access Tokens 创建一个 PAT，然后 multiflow login --token <mul_...> 直接填入。

Token 类型的详细区分见认证与令牌。

认证与初始化

命令	用途
`multiflow login`	登录并保存 PAT
`multiflow auth status`	查看当前登录状态、用户、工作区
`multiflow auth logout`	清除本地 PAT
`multiflow setup cloud`	Multiflow Cloud 一键初始化（登录 + 装 daemon）
`multiflow setup self-host`	自部署后端的一键初始化

工作区和成员

命令	用途
`multiflow workspace list`	列出你有权访问的所有工作区
`multiflow workspace create --name "..." --slug "..." [--issue-prefix "..."] [--description "..."] [--context "..."]`	创建工作区（你会成为 owner）。`--name` 和 `--slug` 必填，slug 创建后不可修改；不会切换你当前的工作区。
`multiflow workspace get <slug>`	查看一个工作区的详情
`multiflow workspace member list`	列出当前工作区的成员
`multiflow workspace update <id> --name "..." [--description "..."] [--context "..."] [--issue-prefix "..."]`	修改 workspace 元数据（admin/owner 权限）。长文本可用 `--description-stdin` / `--context-stdin`。

list 类命令（multiflow issue list、autopilot list、project list 等）表格里默认显示可直接复制的短 ID：issue 是 key（如 MUL-123），其余资源是 UUID 短前缀。下面表格里的 <id> 同时接受短 ID 和完整 UUID，所以典型用法是 multiflow issue list → 复制 key → multiflow issue get MUL-123。需要完整 UUID 时给 list 加 --full-id。

命令	用途
`multiflow issue list`	列出 issue（默认显示可复制的 issue key）
`multiflow issue get <id>`	查看单条 issue（接受 issue key 或 UUID）
`multiflow issue create --title "..."`	创建新 issue
`multiflow issue update <id> ...`	修改 issue（状态、优先级、分配人等）
`multiflow issue assign <id> --to <name>`	分配给成员、智能体或小队（分配给智能体会触发一次运行）
`multiflow issue status <id> <status>`	快捷改状态
`multiflow issue search <query>`	关键字搜索
`multiflow issue children <id>`	按 stage 分组查看子 issue
`multiflow issue pull-requests <id>`	查看关联 PR 及其状态
`multiflow issue runs <id>`	查看 issue 上智能体跑过的任务
`multiflow issue run-messages <task-id>`	查看某次执行的消息
`multiflow issue usage <id>`	查看单个 issue 聚合 token 用量
`multiflow issue rerun <id>`	给该 issue 当前的智能体分配人重新创建一条任务
`multiflow issue cancel-task <task-id>`	取消排队中或运行中的任务
`multiflow issue comment <id> ...`	嵌套：看 / 发评论
`multiflow issue comment resolve/unresolve <comment-id>`	标记评论线程已解决 / 未解决
`multiflow issue subscriber <id> ...`	嵌套：订阅 / 取消订阅
`multiflow issue metadata <id> ...`	嵌套：读写 issue metadata
`multiflow issue label <id> ...`	嵌套：管理 issue 上的 label
`multiflow project list/get/create/update/delete/status`	Project CRUD
`multiflow label list/create/update/delete`	Workspace label CRUD

智能体和 Skill

命令	用途
`multiflow agent list`	列出工作区的智能体
`multiflow agent get <slug>`	查看智能体配置
`multiflow agent create ...`	创建智能体
`multiflow agent update <slug> ...`	修改智能体
`multiflow agent archive <slug>`	归档
`multiflow agent restore <slug>`	恢复归档的智能体
`multiflow agent tasks <slug>`	查看智能体的任务历史
`multiflow agent avatar <slug>`	上传智能体头像
`multiflow agent env <slug> ...`	读取或替换智能体的 custom environment variables
`multiflow agent skills ...`	嵌套：挂载 / 卸载 Skill
`multiflow skill list/get/create/update/delete`	Skill CRUD
`multiflow skill import ...`	从 GitHub / ClawHub / 本机导入 Skill
`multiflow skill files ...`	嵌套：管理 Skill 的文件

Skill 导入冲突

multiflow skill import --url <url> 默认等同于 --on-conflict fail。如果工作区里已经有同名 Skill，命令会返回结构化 conflict 结果并退出，不会修改工作区。

如果你是已有 Skill 的 creator，并且想用新导入内容覆盖它，同时保留原 Skill 的 ID 和 agent 绑定，用 --on-conflict overwrite。如果想保留已有 Skill、另存一份，用 --on-conflict rename，系统会自动加 -2 这类后缀。如果只是批量导入时遇到同名项就跳过，用 --on-conflict skip。

multiflow skill import --url https://skills.sh/acme/repo/review-helper
multiflow skill import --url https://skills.sh/acme/repo/review-helper --on-conflict overwrite
multiflow skill import --url https://skills.sh/acme/repo/review-helper --on-conflict rename
multiflow skill import --url https://skills.sh/acme/repo/review-helper --on-conflict skip

小队

命令	用途
`multiflow squad list`	列出工作区里的小队
`multiflow squad get <id>`	查看一个小队
`multiflow squad create --name "..." --leader <agent>`	创建小队（owner / admin）
`multiflow squad update <id> ...`	修改名字、描述、instructions、队长、头像
`multiflow squad delete <id>`	归档（软删除）—— 同时把分配给小队的 issue 转给队长
`multiflow squad member list/add/remove/set-role <squad-id>`	管理小队成员并原地更新 role
`multiflow squad activity <issue-id> <action\|no_action\|failed> --reason "..."`	队长智能体每轮结束时调用，记录 evaluation

完整模型见小队。

Autopilots

命令	用途
`multiflow autopilot list`	列出工作区所有 autopilot
`multiflow autopilot get <id>`	查看单个 autopilot
`multiflow autopilot create ...`	创建 autopilot
`multiflow autopilot update <id> ...`	修改
`multiflow autopilot delete <id>`	删除
`multiflow autopilot runs <id>`	查看运行历史
`multiflow autopilot trigger <id>`	手动触发一次
`multiflow autopilot trigger-add/update/delete <id>`	管理 schedule 或 webhook trigger
`multiflow autopilot trigger-rotate-url <id> <trigger-id>`	轮换 webhook trigger URL

multiflow autopilot create/update 还支持 --subscriber，为 create_issue 模式创建的 issue 设置默认订阅人；update 支持 --clear-subscribers 清空默认订阅人。

守护进程和运行时

命令	用途
`multiflow daemon start`	启动 daemon（默认后台；加 `--foreground` 前台跑）
`multiflow daemon stop`	停止 daemon
`multiflow daemon restart`	重启 daemon
`multiflow daemon status`	查看 daemon 是否在线 + 并发情况
`multiflow daemon logs`	查看 daemon 日志
`multiflow runtime list`	列出当前工作区的 runtime
`multiflow runtime usage`	查看资源使用情况
`multiflow runtime activity`	近期活动记录
`multiflow runtime update <id> ...`	在某个 runtime 上触发 CLI 更新
`multiflow runtime delete <id> [--cascade]`	删除 runtime，可选择同时归档绑定的智能体
`multiflow runtime profile ...`	管理自定义 runtime profile 和本机路径覆盖

杂项

命令	用途
`multiflow repo checkout <url>`	把 repo 拉到本地以供智能体使用
`multiflow config`	查看 / 修改 CLI 本地配置
`multiflow version`	显示 CLI 版本
`multiflow update`	升级 CLI 到最新版
`multiflow attachment download <id>`	下载 issue / 评论的附件

查完整 flag

每条命令都支持 --help：

multiflow issue create --help
multiflow agent update --help

v2 会给每条命令一个独立的详细 reference 页。

下一步

认证与令牌 —— PAT / JWT / Daemon Token 的区别
守护进程与运行时 —— daemon 命令背后的工作机制
创建和配置智能体 —— multiflow agent create 的完整选项