CLI 参考

本章介绍 AggRoot 命令行界面的布局、命令、快捷键和启动参数。

CLI 界面布局

AggRoot 采用分屏布局，清晰分离输出和输入区域：

┌──────────────────────────────────────────────────────────────┐
│                                                              │
│                     输出区域                                  │
│              （可滚动的对话历史）                               │
│              （支持 Markdown 渲染）                            │
│                                                              │
├──────────────────────────────────────────────────────────────┤  ← 分隔线
│ Agent> _                                                     │  ← 输入行
├──────────────────────────────────────────────────────────────┤  ← 分隔线
│ deepseek-v4-flash | Token: 1234/5678 | Mode: coding | MCP: 2    │  ← 状态栏
└──────────────────────────────────────────────────────────────┘

各区域说明

区域	说明
输出区域	显示对话历史，支持 Markdown 渲染，可上下滚动浏览
输入行	以 `Agent>` 为提示符，输入指令和问题
状态栏	显示当前模型、Token 使用量、工作模式、MCP 服务器数量

状态栏信息

状态栏从左到右显示以下信息：

信息	说明	示例
模型名称	当前使用的 AI 模型	`deepseek-v4-flash`、`gpt-5.5`、`glm-5.2`
Token 用量	已使用 / 总可用 Token	`1234/5678`
工作模式	当前代理的工作模式	`coding`、`chat`、`explore`
MCP 服务器数	已连接的 MCP 服务器数量	`MCP: 2`

斜杠命令

在输入行中输入 /命令 执行斜杠命令：

命令	别名	说明
`/help`	`/h`, `/?`	显示帮助信息
`/model <id>`	—	切换 AI 模型
`/agents`	—	列出所有可用代理
`/switch [n]`	—	切换到指定会话（按编号）
`/reset`	—	重置当前会话
`/sessions`	—	列出所有会话
`/undo [path]`	—	撤销文件变更
`/memory`	—	管理项目记忆（list/add/delete/search）
`/init`	—	生成 AGGROOT.md 项目文档
`/yolo`	—	切换自动执行模式（跳过确认）
`/export [format]`	—	导出对话（支持 markdown、json）
`/config`	—	显示当前配置
`/history`	—	显示命令历史
`/clear`	`/cls`	清屏
`/exit`	`/quit`, `/q`	退出程序

命令详解

/model — 切换模型

/model deepseek-v4-flash
/model gpt-5.5
/model claude-opus-4-8

也可以按 $ 键打开模型选择菜单。

/memory — 记忆管理

/memory                # 显示记忆统计
/memory list           # 列出所有记忆
/memory add            # 添加新记忆
/memory delete <id>    # 删除指定记忆
/memory search <query> # 搜索记忆

/export — 导出对话

/export markdown       # 导出为 Markdown 文件
/export json           # 导出为 JSON 文件

/undo — 撤销变更

/undo                  # 撤销最近一次文件变更
/undo src/config.ts    # 撤销指定文件的变更

快捷键

在输入行中可以使用以下快捷键：

快捷键	说明
`$`	打开模型选择菜单
`#`	打开代理选择菜单
`@`	插入文件引用
`/`	显示命令列表
`↑` / `↓`	浏览历史输入
`Enter`	发送消息
`Ctrl+C`	中断当前操作
`Ctrl+L`	清屏

快捷菜单

$ 模型选择 — 弹出可用模型列表，用方向键选择后按回车确认
# 代理选择 — 弹出可用代理列表，切换当前代理
@ 文件引用 — 在输入中插入文件路径，AggRoot 会自动读取文件内容

命令行参数

从终端启动 AggRoot 时可以指定以下参数：

基本用法

aggroot                          # 以默认设置启动
aggroot --model deepseek-v4-flash    # 指定模型启动
aggroot --model gpt-5.5              # 使用 OpenAI GPT-5.5
aggroot --mcp-server             # 以 MCP 服务器模式启动

参数列表

参数	说明
`--model <id>`	指定使用的 AI 模型
`--mcp-server`	以 MCP 服务器模式启动，暴露工具给其他应用
`--help`	显示帮助信息
`--version`	显示版本号

输入模式

AggRoot 的输入行使用 Raw Mode，提供完整的键盘支持：

方向键浏览历史
Home / End 跳转到行首/行尾
Ctrl+A / Ctrl+E 跳转到行首/行尾（Emacs 风格）
Ctrl+U 清除当前行
Ctrl+W 删除前一个单词

Raw Mode 让 AggRoot 在终端中的交互体验更接近现代 Shell。

交互示例

基本对话

Agent> 你好，请介绍一下这个项目
AggRoot: 这是一个基于 Node.js + TypeScript 的 AI 编程助手...

使用文件引用

Agent> @src/config.ts 这个文件的配置项有哪些？

按 @ 后输入文件名，AggRoot 会自动读取文件内容。

切换模型

Agent> $
[模型选择菜单]
> deepseek-v4-flash
  gpt-5.5
  claude-opus-4-8
  glm-5.2
  ollama:llama3.2

查看可用代理

Agent> /agents
可用代理:
  - coding (编码代理)
  - explore (探索代理)
  - plan (规划代理)
  - code-reviewer (代码审查代理)

使用技能

Agent> /explain React hooks --level beginner
Agent> /test src/domain/agent/aggregate.ts
Agent> /commit

常见操作速查

操作	方法
切换模型	`$` 或 `/model <id>`
切换代理	`#` 或 `/agents`
插入文件	`@`
查看命令	`/`
开启自动执行	`/yolo`
查看配置	`/config`
导出对话	`/export markdown`
撤销变更	`/undo`
清屏	`/clear` 或 `Ctrl+L`
退出	`/exit` 或 `/q`

← 上一篇

设置与配置

代理配置文件