reasonix help
命令速查,照抄就能用
完整命令表来自 reasonix --help 的真实输出(v1.19)。每条命令都可以点「复制」直接粘贴到终端。
01
会话与任务 核心
| 命令 | 作用 | 示例 |
|---|---|---|
| reasonix | 进入交互式会话 | reasonix |
| reasonix -c / --continue | 继续上次会话 | reasonix --continue |
| reasonix -r / --resume [QUERY] | 恢复到指定会话(支持查询式恢复) | reasonix --resume provider-config |
| reasonix run <task> | 运行一个完整任务 | reasonix run "实现 TODO" |
| reasonix -p / --print <task> | 一次性输出,适合管道;--output-format text/json/stream-json | reasonix -p "总结仓库" --output-format json |
| reasonix run --events-jsonl | 输出脱敏结构化事件 JSONL,供自动化消费 | reasonix run --events-jsonl "补测试" > e.jsonl |
02
代码审查与接入
| 命令 | 作用 | 示例 |
|---|---|---|
| reasonix review | AI 审查当前分支改动(基于本地 diff) | reasonix review |
| reasonix review --base BRANCH | 以指定分支为基准审查 | reasonix review --base main |
| reasonix review --commit SHA | 审查某个提交 | reasonix review --commit a1b2c3d |
| reasonix serve | HTTP+SSE 服务;--addr --auth none/token/password --token/--password/--hash-password | reasonix serve --auth token --token xyz |
| reasonix acp | 通过 stdio 提供 Agent Client Protocol(或 --acp) | reasonix acp |
03
配置与模型
| 命令 | 作用 | 示例 |
|---|---|---|
| reasonix setup [path] | 交互式配置向导,生成 reasonix.toml 与 .env | reasonix setup |
| reasonix config reasoning-language [auto|zh|en] | 配置可见思考语言 | reasonix config reasoning-language zh |
| reasonix config compact-ratio [65..85] | 配置自动压缩阈值(--local 仅当前项目) | reasonix config compact-ratio 75 |
| reasonix config telemetry [auto|on|off] | 配置不含内容的 CLI 使用统计 | reasonix config telemetry off |
| reasonix mcp <add|remove|list|import> | 管理 reasonix.toml 里的 MCP 服务器 | reasonix mcp import .mcp.json |
| reasonix init | 查看如何生成项目记忆(AGENTS.md) | reasonix init |
| reasonix --model NAME | 通用参数:指定模型;另有 --permission-mode --effort --add-dir --allowed-tools | reasonix run --model mimo-pro "补测试" |
优先级配置优先级:命令行 flag >
./reasonix.toml > ~/.config/reasonix/config.toml > 内置默认值。密钥通过 api_key_env 从环境变量注入。
04
子智能体与 bot
| 命令 | 作用 | 示例 |
|---|---|---|
| reasonix subagent <list|create|edit|delete|try|run> | 管理和运行隔离子智能体 profile | reasonix subagent run review "审查改动" |
| reasonix bot start | 启动多渠道 IM bot 网关 | reasonix bot start |
| reasonix bot doctor | 诊断 bot 状态 | reasonix bot doctor |
| reasonix bot weixin-login | 微信渠道扫码登录 | reasonix bot weixin-login |
05
诊断、状态与维护
| 命令 | 作用 | 示例 |
|---|---|---|
| reasonix doctor [--json] | 输出脱敏的本地诊断信息 | reasonix doctor --json |
| reasonix doctor session <branch-id> | 导出会话冲突诊断 zip(--zip --out) | reasonix doctor session abc --zip |
| reasonix session list / status / recovery | 为机器客户端列出/查询脱敏会话与恢复状态(--json) | reasonix session list --json |
| reasonix hook list / status | 查看脱敏 Hook 状态(--json) | reasonix hook status --json |
| reasonix task list / show | 查看脱敏 Task 状态(--json) | reasonix task show 42 --json |
| reasonix report <list|show|send|delete> [ID] | 审阅并明确发送本地 CLI 崩溃报告 | reasonix report list |
| reasonix upgrade [--check|--force] | 更新到最新正式版 | reasonix upgrade --check |
| reasonix version / help | 版本信息与帮助 | reasonix version |
06
常用组合
几个高频工作流的完整命令。
# 每天开工:继续昨天的会话
$ reasonix --continue
# 改完代码立刻审查
$ reasonix run "实现新功能并补测试" && reasonix review
# 只读总结,输出给别的工具
$ reasonix -p "总结这个仓库的模块结构" --output-format json | jq .