命令行使用参考

权威参考：本页维护全部 CLI 命令、选项和组合规则。README 与官网入口页只保留摘要和跳转链接。

这份文档说明当前 CLI 的入口、选项组合和参数边界。交互模式中的 / 指令见交互模式。

基本结构

mind [OPTIONS] [PROMPT]
mind [OPTIONS] <COMMAND> [ARGS]

• 不带子命令时进入交互模式，可附带一条初始提示词。
• 单次非交互任务使用 mind exec，也可以使用短别名 mind e。
• 使用 mind <command> --help 查看某个命令的实时参数；例如 mind exec --help。
• 使用 mind help <command...> 也可以查看多级命令帮助；例如 mind help mcp add。

当前命令如下：

命令	用途
mind	进入交互模式
mind exec / mind e	执行一次非交互任务
mind resume	恢复已有交互会话
mind archive	按会话 ID 或标题归档会话
mind unarchive	按会话 ID 或标题恢复归档会话
mind agent	远端任务订阅命令组（当前子命令为 listen）
mind agent listen	监听远端下发任务
mind upgrade	运行组件升级命令组（当前子命令为 helix）
mind upgrade helix	下载或更新 Helix 运行组件
mind doctor	只读诊断本地运行环境
mind mcp	外部 MCP 服务命令组
mind mcp list/get/add/remove/enable/disable/help	管理外部 MCP 服务注册
mind mcp-server	通过 stdio 暴露 MCP 服务
mind completion	生成 shell 补全脚本
mind help [COMMAND...]	查看根命令或多级子命令帮助

进程级选项

配置、沙箱和审批选项都是进程级选项，可以写在子命令之前或之后：

mind -p work exec "检查当前项目"
mind exec "检查当前项目" -p work
mind exec "检查当前项目" -c 'model_providers.openai-main.reasoning_effort="high"'

选项	说明
-c, --config <key=value>	按点路径临时覆盖配置；值优先按 TOML 解析，可重复传入
-p, --profile <PROFILE>	在基础配置之上叠加 ~/.mind/<name>.config.toml
-s, --sandbox <MODE>	选择 read-only、workspace-write 或 danger-full-access
-a, --ask-for-approval <POLICY>	选择 untrusted、on-request 或 never
-V, --version	输出版本号
-h, --help	输出帮助

-c 只覆盖本次进程。包含数组、字符串或特殊字符的值应按当前 shell 的规则加引号。

本地 JavaScript REPL 和子 Agent 能力由 config.toml 的启动期开关控制：

[features]
js_repl = false
subagents = false

将对应值改为 true 才会启用能力。

关闭 js_repl 会同时移除 js_repl 和 js_repl_reset；关闭 subagents 会停止注册全部 Agent 协作工具，并禁止创建或控制子 Agent。[agents] 仅保留 max_concurrent_threads_per_session、max_depth、default_fork_turns 和 max_fork_context_chars 等运行参数。修改这些能力开关后需要重新启动进程。

交互模式

mind
mind "先检查当前项目结构"
mind -m gpt-5.5 "先检查当前项目结构"
mind -i .\screen.png "分析这张截图"
mind -H api "检查接口"

根命令支持：

选项	说明
-m, --model <MODEL>	为本次运行覆盖主模型
-i, --image <FILE>	添加初始图片；可重复，也可用逗号分隔多个路径
-H, --helix [PROFILE]	接入 Helix；省略 profile 时使用 app，也可选择 api

-m 是本次运行的临时覆盖，不会写入持久配置。需要在交互会话中持久修改模型时，使用 /model 或 /preferences。

单次执行

mind exec [OPTIONS] [PROMPT]
mind e [OPTIONS] [PROMPT]

常用示例：

# 非交互运行默认使用 read-only 和 never
mind exec "检查当前项目并给出结论"

# 选择沙箱、审批策略和本次模型
mind exec -s workspace-write -a on-request -m gpt-5.5 "修复测试失败"

# 输出 newline-delimited JSON 事件
mind exec --json "检查当前项目"

# 本次运行启动或复用 Helix；省略 profile 时使用 app
mind exec --helix "检查设备状态"

# 接入 Helix 并使用 api 工具过滤器
mind exec --helix api "检查接口状态"

exec 选项：

选项	说明
--json	输出 JSONL 事件流
--dangerously-bypass-hook-trust	本次执行跳过已启用 Hook 的当前内容信任检查
-H, --helix [PROFILE]	启动或复用本地 Helix；profile 可选 app 或 api，默认 app
-i, --image <FILE>	添加图片附件
-m, --model <MODEL>	临时覆盖本次请求使用的主模型

图片组合

图片选项可以写在 exec 前，也可以写在 exec 的 prompt 前后：

mind -i .\overview.png exec "分析图片"
mind exec -i .\overview.png "分析图片"
mind exec "分析图片" -i .\overview.png

多张图片可以重复传入选项，也可以使用逗号分隔：

mind exec "比较两张图片" -i .\before.png -i .\after.png
mind exec "比较两张图片" --image ".\before.png,.\after.png"

根命令和 exec 子命令都提供图片时，会按命令行顺序合并，不会互相覆盖：

mind -i .\overview.png exec -i .\detail.png "结合全图和细节图分析"

路径包含空格或其他特殊字符时应加引号：

mind exec "这是什么图" --image "C:\Users\Administrator\Downloads\公司文档\18891368635813248.png"

模型组合

模型可以放在根命令或 exec 子命令：

mind -m gpt-5.5 exec "检查当前项目"
mind exec "检查当前项目" -m gpt-5.5

两处都传入时，离具体命令更近的 exec --model 优先。模型覆盖只作用于本次执行，不写入 config.toml。

标准输入组合

显式 prompt 可以和管道输入同时使用。管道内容会作为 <stdin>...</stdin> 上下文附加到 prompt：

Get-Content .\build.log | mind exec "总结失败原因"
git diff | mind exec "审查这些改动"

使用 - 可以明确要求从标准输入读取完整 prompt；省略 prompt 时，非交互标准输入也会被读取：

Get-Content .\task.txt | mind exec -
Get-Content .\task.txt | mind exec

恢复会话

mind resume
mind resume --last
mind resume <SESSION_ID> "继续检查剩余问题"
mind resume --helix api

选项	说明
--last	不打开选择器，直接恢复最近会话
--all	显示所有工作目录的会话
--include-non-interactive	同时显示由非交互命令创建的会话
-i, --image <FILE>	为恢复后的首条消息添加图片
-m, --model <MODEL>	临时覆盖恢复会话使用的主模型
-H, --helix [PROFILE]	恢复时接入 Helix；省略 profile 时使用 app

根命令上的 -i/--image 和 -m/--model 同样会传播给 resume；子命令模型优先，图片按顺序合并。

会话归档

mind archive <SESSION_ID_OR_TITLE>
mind unarchive <SESSION_ID_OR_TITLE>

archive 将匹配到的会话标记为 archived，unarchive 将其恢复为 active。目标可以是会话 ID， 也可以是精确的历史标题；两个命令都只执行一次状态变更后退出，不启动交互会话。

外部 MCP 管理

查询和启停

mind mcp list
mind mcp list --json
mind mcp get playwright
mind mcp get playwright --json
mind mcp enable playwright
mind mcp disable playwright
mind mcp remove playwright
mind mcp help
mind mcp help add

添加远端服务

mind mcp add dbhub --url https://example.com/mcp
mind mcp add dbhub --url https://example.com/mcp `
  --bearer-token-env-var DBHUB_TOKEN `
  --env-http-header "X-Tenant=DBHUB_TENANT" `
  --required

远端服务可以重复使用 --header、--env-http-header、--allow 和 --deny。--startup-timeout-sec 控制启动和工具发现超时，--tool-timeout-sec 控制工具调用超时。

mcp add 的选项边界如下：

选项	适用服务	说明
--url <URL>	远端	注册 streamable HTTP MCP 服务
--bearer-token-env-var <ENV_VAR>	远端	从环境变量读取 bearer token
--header <KEY=VALUE>	远端	添加 HTTP header，可重复
--env-http-header <HEADER=ENV_VAR>	远端	从环境变量读取 HTTP header，可重复
--env <KEY=VALUE>	stdio	设置子进程环境变量，可重复
--cwd <DIR>	stdio	设置子进程工作目录
--disabled	两者	注册但不在启动时启用
--required	两者	初始化失败时让启动失败
--allow/--deny <PATTERN>	两者	按工具名或 glob 过滤，可重复
--approval-mode <MODE>	两者	设置 auto、prompt、writes 或 approve 工具审批模式
--startup-timeout-sec <SECONDS>	两者	启动和工具发现超时
--tool-timeout-sec <SECONDS>	两者	工具请求超时

添加 stdio 服务

stdio 子进程命令必须放在 -- 之后：

mind mcp add playwright -- npx -y @playwright/mcp@latest
mind mcp add local-tools --env "TOKEN=value" --cwd "D:\tools" -- python server.py

-- 会结束 Mind 自身的选项解析，后面的参数全部原样传给子进程。因此子进程自己的 --model、--image 等参数不会被 Mind 消费：

mind mcp add demo -- server --model child-model

远端 URL 与 stdio 命令不能同时使用。--env 和 --cwd 只用于 stdio 服务；HTTP header 和 bearer token 选项只用于远端服务。

外部工具审批与传输边界

外部 MCP 的 approval-mode 只控制模型发起的工具效果：prompt 每次询问，writes 对不是明确 只读的工具询问，auto 根据 MCP annotations 判断且在信息不足时询问，approve 明确跳过逐次 询问。全局 approval_policy=never 遇到仍需询问的 MCP 工具时直接拒绝，不会静默执行。

连接用户配置的 STDIO、SSE 或 Streamable HTTP 服务属于显式配置的传输信任边界，建立连接不会 生成网络审批卡，也不会把 MCP tool grant 当成网络 grant。HTTP client 不读取环境代理配置； 远端 bearer token 和动态 header 应优先通过 --bearer-token-env-var / --env-http-header 注入。 列表、状态和传输错误会隐藏凭据，运行时关闭时会终止连接 owner 并清空工具与会话引用。

其他命令

doctor 会检查全部内置命令行工具；在 macOS 上还会报告缺失执行位或仍携带 com.apple.quarantine 的工具，但不会实际启动这些程序。

# 只读诊断；JSON 形式适合脚本消费
mind doctor
mind doctor --json

# 监听远端下发任务，需要 Helix app 时添加 --helix
mind agent listen
mind agent listen --helix

# 使用 Helix api 工具过滤器
mind agent listen --helix api

# 更新 Helix 运行组件
mind upgrade helix

# 通过 stdio 向 MCP host 暴露服务
mind mcp-server

# 生成补全脚本
mind completion powershell
mind completion bash
mind completion zsh
mind completion fish
mind completion elvish

# 查看根命令或多级子命令帮助
mind help
mind help mcp add

mind mcp-server 的 host 配置和生命周期见 MCP Server，agent listen 的恢复链路见订阅模式。

组合规则速查

• -c/--config 和 -p/--profile 是进程级选项，可以跨命令层级提取。
• 根命令的图片和模型会传播给 exec 与 resume。
• 图片会合并；具体子命令上的模型会覆盖根模型。
• 不传 --helix 时不连接 Helix；传入但省略 profile 时使用 app。
• exec 的显式 prompt 可以和非交互 stdin 同时使用。
• mcp add ... -- <COMMAND> 中 -- 之后的参数只属于 stdio 子进程。
• 遇到组合疑问时，以 mind --help 和 mind <command> --help 的当前输出为准。