CLI 参考

QitOS 的 qita 与 qit 命令行参考，包括最小编码智能体演示和 v0.3 中加入的基准测试官方入口。

当前推荐 qit new → canonical config → Python composition/Session。自定义 Python 工具不会由 CLI 自动导入。先读 Quickstart，再使用下面的 inspect 命令。旧 demo 是高级兼容入口。 Quickstart

​

当前 Session 命令

qit --help
qita --help
qit new --agent-name notes_agent --output-dir . --no-input
qit session inspect --help
qit session restore --help
qit session fork --help
qita inspect --help

inspect 无需模型或 Docker。真实 Session ID、matching config 及完整运行命令见生命周期教程。replay 与 board 启动本地服务器，需 Ctrl-C 停止后才能在同一终端执行后续命令。 Session

QitOS 提供两个顶层命令行工具：

• qita：追踪记录检查与回放
• qit：演示、基准测试与开发者工作流入口

​

qit demo

当你想最快拿到一次真正的模型驱动 QitOS 运行时，使用 qit demo。

​

qit demo minimal

qit demo minimal

这个命令会：

• 从环境变量或标志位读取 OpenAI 兼容模型配置
• 先创建一个最小缺陷工作区
• 运行最小编码智能体去修这个缺陷
• 把 qita 可识别的追踪记录写到 ./runs

可选参数：

• --workspace ./playground/minimal_coding_agent
• --logdir ./runs
• --model-name Qwen/Qwen3-8B
• --base-url https://api.siliconflow.cn/v1/
• --api-key sk-...
• --task "Fix the bug in buggy_module.py and make the verification command pass."
• --max-steps 8
• --render

​

qita

当你要检查已有追踪记录时，使用 qita。

​

qita board

qita board --logdir ./runs

打开多运行面板，支持：

• 运行列表与过滤
• 对比选择
• 进入运行详情
• 回放
• 原始或 HTML 导出

​

qita replay

qita replay --run ./runs/<run_id>

以时间轴方式打开一个运行。

​

qita export

qita export --run ./runs/<run_id> --html ./report.html

导出独立 HTML 产物。

有界 canonical export 使用明确的 journal 来源与 run ID，默认 public 投影；私有视图需显式 --raw-private。输出仅在快照校验和原子替换成功后完成；HTML export 保持原行为。

qita export --run RUN_ID --journal ./runs/trajectory.journal --canonical ./trajectory.json

​

qit bench

qit bench 是 v0.3 中基准测试的官方命令行。

​

qit bench run

qit bench run \
  --benchmark tau-bench \
  --split test \
  --subset retail \
  --limit 10 \
  --output ./results/tau.jsonl

这个命令会：

• 加载基准测试任务
• 构造 RunSpec 与 ExperimentSpec
• 输出统一的 BenchmarkRunResult

现在常见的基准测试名称包括：

• desktop-starter：标准入门基准测试族
• osworld：基准测试专用 OSWorld 适配器路径
• gaia、tau-bench、cybench：已经迁入 qitos.benchmark.* 的基准测试族
• desktop：desktop-starter 的兼容别名

当前命令行默认遵循三层结构：

• qitos.benchmark.*：基准测试适配器与评估器
• qitos.recipes.*：标准基线方法
• examples/*：最薄的入口封装

​

qit bench eval

qit bench eval --input ./results/tau.jsonl --json

聚合统一基准测试结果。

​

qit bench replay

qit bench replay --run ./runs/<run_id>

把基准测试运行直接桥接到 qita 回放。

​

qit bench export

qit bench export --run ./runs/<run_id> --html ./report.html

把基准测试运行导出成独立 HTML。

​

qit skill

qit skill <subcommand>

用于管理 QitOS 工作流中使用的第三方技能。

​

推荐流程

第一次跑通时，推荐：

1. export OPENAI_API_KEY=...
2. qit demo minimal
3. qita board

做基准测试工作时，推荐：

1. qit bench run
2. qit bench eval
3. qita board
4. qit bench replay
5. qit bench export

如果你还想理解这条路径背后的设计，请继续阅读 官方运行 与 追踪。