CLI 命令速查
NSTACK Agents CLI 的所有顶级命令一页概览。完整用法查 `concierto <命令> --help`。
NSTACK Agents CLI 把 Web UI 能做的事几乎全部搬到了命令行上（创建 issue、分配 智能体、启动 守护进程 等等）。这一页把所有顶级命令列出来，每条配一句用途。完整 flag 和示例用 concierto <命令> --help 查。
认证入口
第一次用 CLI 时先登录，拿一个个人访问令牌（Personal Access Token，PAT）：
concierto login浏览器会自动打开并落在 Authorize CLI 授权页（"Allow the CLI to access NSTACK AI · Concierto as you@example.com"）。已登录时直接点 Authorize；未登录先完成登录（也可以点 Use a different account 换账号）。Web 端把令牌交还给 CLI，CLI 再换取一个有效期 90 天、名为 CLI (<主机名>) 的 PAT（nst_ 前缀），保存到 ~/.concierto/config.json。此后所有命令都会自动用这个 PAT 认证。
登录完成后 CLI 会自动发现你的工作区并设置默认值；如果你还没有工作区，它会在浏览器里打开创建页并等待。
CI / 无浏览器环境跳过浏览器流程：先在 Web 端 Settings → Personal Access Tokens 创建一个 PAT，然后 concierto login --token <nst_...> 直接填入。
Token 类型的详细区分见 认证与令牌。
认证与初始化
| 命令 | 用途 |
|---|---|
concierto login | 登录并保存 PAT |
concierto auth status | 查看当前登录状态、用户、工作区 |
concierto auth logout | 清除本地 PAT |
concierto setup cloud | NSTACK Agents Cloud 一键初始化（登录 + 装 daemon） |
concierto setup self-host | 自部署后端的一键初始化 |
工作区和成员
| 命令 | 用途 |
|---|---|
concierto workspace list | 列出你有权访问的所有工作区 |
concierto workspace get <slug> | 查看一个工作区的详情 |
concierto workspace members | 列出当前工作区的成员 |
concierto workspace update <id> --name "..." [--description "..."] [--context "..."] [--issue-prefix "..."] | 修改 workspace 元数据（admin/owner 权限）。长文本可用 --description-stdin / --context-stdin。 |
Issue 和 Project
list 类命令（concierto issue list、autopilot list、project list 等）表格里默认显示可直接复制的短 ID：issue 是 key（如 TRK-123），其余资源是 UUID 短前缀。下面表格里的 <id> 同时接受短 ID 和完整 UUID，所以典型用法是 concierto issue list → 复制 key → concierto issue get TRK-123。需要完整 UUID 时给 list 加 --full-id。
| 命令 | 用途 |
|---|---|
concierto issue list | 列出 issue（默认显示可复制的 issue key） |
concierto issue get <id> | 查看单条 issue（接受 issue key 或 UUID） |
concierto issue create --title "..." | 创建新 issue |
concierto issue update <id> ... | 修改 issue（状态、优先级、分配人等） |
concierto issue assign <id> --agent <slug> | 分配给智能体（立即触发任务） |
concierto issue status <id> --set <status> | 快捷改状态 |
concierto issue search <query> | 关键字搜索 |
concierto issue runs <id> | 查看 issue 上智能体跑过的任务 |
concierto issue run-messages <task-id> | 查看某次运行的消息记录 |
concierto issue rerun <id> | 给该 issue 当前的智能体分配人重新创建一条任务 |
concierto issue cancel-task <task-id> | 取消运行中 / 排队中的任务（会打断执行中的智能体） |
concierto issue certify <id> | 关闭前用结构化结果为 track 的产出做认证 |
concierto issue review <id> | 记录队长对成员产出物的评审结论 |
concierto issue contract get/restate <id> | 读取或重述 track 的成功契约（好的定义 + 验收标准） |
concierto issue comment <id> ... | 嵌套：看 / 发评论 |
concierto issue subscriber <id> ... | 嵌套：订阅 / 取消订阅 |
concierto issue label list/add/remove <issue-id> | 管理单条 issue 上的标签 |
concierto project list/get/create/update/delete/status | Project CRUD |
concierto label list/get/create/update/delete | 工作区标签 CRUD |
决策与 field note
这两组命令主要供智能体向人类发起沟通，但任何人都可以用：
| 命令 | 用途 |
|---|---|
concierto decision ask <issue-id> | 向人类发起结构化决策：一个问题 + 2–6 个具体选项，会出现在 Needs You |
concierto decision list | 列出决策请求（工作区全量，或限定某个 track） |
concierto field-note add <issue-id> | 记录工作中发现的罕见、有出处的发现（见 Field notes） |
concierto field-note list | 列出工作区的 field note |
智能体和 Skill
| 命令 | 用途 |
|---|---|
concierto agent list | 列出工作区的智能体 |
concierto agent get <slug> | 查看智能体配置 |
concierto agent create ... | 创建智能体 |
concierto agent update <slug> ... | 修改智能体 |
concierto agent archive <slug> | 归档 |
concierto agent restore <slug> | 恢复归档的智能体 |
concierto agent tasks <slug> | 查看智能体的任务历史 |
concierto agent avatar <slug> | 设置智能体头像 |
concierto agent roster | 列出官方专家名册以及哪些已被雇入 |
concierto agent hire <canonical-slug> | 从名册雇一位专家进工作区（skill 已预挂载，可重复执行） |
concierto agent skills ... | 嵌套：挂载 / 卸载 Skill |
concierto skill list/get/create/update/delete | Skill CRUD |
concierto skill import ... | 从 GitHub / ClawHub / 本机导入 Skill |
concierto skill files ... | 嵌套：管理 Skill 的文件 |
小队
| 命令 | 用途 |
|---|---|
concierto squad list | 列出工作区里的小队 |
concierto squad get <id> | 查看一个小队 |
concierto squad create --name "..." --leader <agent> | 创建小队（owner / admin） |
concierto squad update <id> ... | 修改名字、描述、instructions、队长、头像 |
concierto squad delete <id> | 归档（软删除）—— 同时把分配给小队的 issue 转给队长 |
concierto squad member list/add/remove <squad-id> | 管理小队成员 |
concierto squad activity <issue-id> <action|no_action|failed> --reason "..." | 队长智能体每轮结束时调用，记录 evaluation |
完整模型见 小队。
Autopilots
| 命令 | 用途 |
|---|---|
concierto autopilot list | 列出工作区所有 autopilot |
concierto autopilot get <id> | 查看单个 autopilot |
concierto autopilot create ... | 创建 autopilot |
concierto autopilot update <id> ... | 修改 |
concierto autopilot delete <id> | 删除 |
concierto autopilot runs <id> | 查看运行历史 |
concierto autopilot trigger <id> | 手动触发一次 |
守护进程和运行时
| 命令 | 用途 |
|---|---|
concierto daemon start | 启动 daemon（默认后台；加 --foreground 前台跑） |
concierto daemon stop | 停止 daemon |
concierto daemon restart | 重启 daemon |
concierto daemon status | 查看 daemon 是否在线 + 并发情况 |
concierto daemon logs | 查看 daemon 日志 |
concierto daemon disk-usage | 按任务 / 工作区查看 daemon 的磁盘占用 |
concierto runtime list | 列出当前工作区的 runtime |
concierto runtime usage | 查看资源使用情况 |
concierto runtime activity | 近期活动记录 |
concierto runtime update <id> ... | 更新 runtime 配置 |
杂项
| 命令 | 用途 |
|---|---|
concierto repo checkout <url> | 把 repo 拉到本地以供智能体使用 |
concierto config | 查看 / 修改 CLI 本地配置 |
concierto version | 显示 CLI 版本 |
concierto update | 升级 CLI 到最新版 |
concierto attachment download <id> | 下载 issue / 评论的附件 |
查完整 flag
每条命令都支持 --help：
concierto issue create --help
concierto agent update --helpv2 会给每条命令一个独立的详细 reference 页。