Skip to content

recursive run

执行单次目标后退出。

bash
recursive run [选项] <目标>

参数

参数说明
<目标>传递给 Agent 的目标字符串

选项

选项默认值说明
--workspace <path>当前目录文件系统沙箱根目录
--max-steps <n>32步骤预算
--session <id>(新建)恢复已有会话
--system-prompt-file <path>(内置)自定义系统提示
--json以 JSON 格式输出结果

示例

bash
# 基本用法
recursive run "列出 src/ 的文件并总结架构"

# 指定工作区
recursive run --workspace /my/project "审查最近的变更"

# 恢复会话
recursive run --session abc123 "继续上次的工作"

# JSON 输出
recursive run --json "2+2等于几" | jq .finish_reason

退出码

代码含义
0FinishReason::NoMoreToolCallsFinishReason::ProviderStop
1运行时错误(作为 Err(...) 返回)
2FinishReason::BudgetExceeded
3FinishReason::Stuck

Released under the MIT License.