• packages/tui：终端运行时包（memo 入口、参数解析、模式分发、纯文本模式 + 交互式 TUI 运行时）。
• packages/core：两种模式使用的会话状态机、工具调用运行时与 LLM 层。

交互式 TUI

memo

最适合：

• 多轮编程对话
• 工具审批提示
• 会话恢复和模型切换

纯文本模式

echo "your prompt" | memo

当 stdin 或 stdout 不是 TTY 时，自动使用纯文本模式。

最适合：

• 脚本和 CI
• 一次性自动化任务

重要限制：

• 纯文本模式无法显示交互式审批 UI；除非使用 --dangerous，否则需要审批的工具会被拒绝。

• --once / -once：执行一轮后退出（走 plain-mode 流程）。
• --prev / -prev：预加载当前目录最近本地会话历史。
• --dangerous / -d：跳过审批检查。

TUI 时间线是实时的：

• 模型输出与推理内容边生成边流入时间线，流式渲染 Markdown
• 进行中的任务计划（update_plan）会以进度面板展示各步骤状态
• Ctrl+T 切换是否跟随实时输出流

思考模式可在会话内随时切换：

• 在空输入框上按 Tab 切换思考模式开关
• 思考模式开启时，输入框显示为琥珀色

该开关会被记住，并在恢复历史会话时一并还原（见下文）。

使用 @ 引用文件

输入 @ 后跟路径片段，然后按 Tab 接受建议。

示例：

• Review @package.json and explain scripts
• Compare @packages/core/src/agent/loop.ts with @packages/core/src/tools/index.ts

会话恢复 (resume)

在输入框中输入：

• resume
• resume keyword
• /resume（相同触发器）

然后选择一个会话建议来加载历史上下文。

恢复会话时也会还原该会话的 UI 状态：提供商、模型、思考开关、工具权限模式、上下文窗口和输入历史。

使用 / 打开命令建议。

• /help：显示帮助和快捷键
• /new：开始新会话并清屏
• /exit：退出 Memo
• /resume：显示历史加载指南
• /models：列出/切换已配置的提供商和模型
• /tools：切换工具权限模式（none / once / full）
• /compact：手动压缩当前会话上下文
• /mcp：显示已配置的 MCP 服务器
• /init：让 Memo 为当前项目生成 AGENTS.md

注意：

• 输入 exit（不带斜杠）也会退出。
• /models <provider-or-model> 也可以工作（用于直接切换）。

Memo 还提供独立的子命令：

memo init               # 为当前项目生成 AGENTS.md（幂等）
memo mcp list           # 列出已配置的 MCP 服务器
memo mcp add <name> -- <command...>
memo mcp login <name>   # 远程 MCP 服务器的 OAuth 登录
memo skills list        # 列出发现的 skills
memo skills read <name> # 读取某个 skill 的完整 SKILL.md

详见 MCP 集成 与 Skills 系统。

• Enter：发送消息
• Shift+Enter：插入换行
• Tab：接受当前建议；在空输入框上切换思考模式
• Up/Down：在建议列表中移动，或浏览输入历史
• Esc：关闭建议面板
• Esc Esc：
  • 运行时：取消当前轮次
  • 空闲时：清除当前输入
• Ctrl+T：切换跟随实时输出
• Ctrl+L：清屏并开始新会话
• Ctrl+D：退出（在空输入框上连按两次）；否则删除光标处字符
• Ctrl+C：退出

当工具需要审批时，会出现一个模态框，包含：

• Allow once（允许一次）
• Allow for this session（允许本次会话）
• Deny（拒绝）
• Memo 还会响终端铃并尝试桌面通知，当审批请求出现时。

详见 安全与审批 了解策略详情。