Mirror CLI

Mirror CLI 是 Reflection 推出的终端编码代理，默认调用 Reflection Beam-1.0-501B-A23B 模型。在项目目录执行 mirror 即可启动会话，你描述开发任务，代理会读取、修改项目文件，执行 shell 命令，全程在终端展示每一步操作。首次在目录启动时，需要确认信任当前目录文件。

Mirror CLI 核心组织架构

单个 Mirror 会话由工作区、对话、工具、指令与技能四部分构成。

• 工作区：对应独立目录，自带专属代理与对话。初始默认当前目录；使用 /worktree 可新增独立检出目录，多个代理并行编辑文件互不干扰。不同工作区相互隔离，切换不会暂停代理，各自独立保存模型、推理努力度、审批模式。
• 对话：保存工作区内所有提示词、模型回复、工具调用记录，存储路径为 ~/.mirror，支持后续恢复会话或者基于历史轮次新建分支。
• 工具：代理操作项目的能力，包含文件检索、读写、执行shell命令，以当前操作系统账号权限运行；还可扩展接入 Linear、Notion 等第三方服务。
• 指令和技能：代理启动前加载的规则，读取项目内 AGENTS.md 和可复用技能目录。

终端界面布局（从上至下）

1. 记录区：对话历史，首次启动展示欢迎页，显示模型与工作目录。快捷键 Ctrl+T 或指令 /view，可切换三种视图：详细视图（完整工具输出与推理过程）、默认视图（分组展示工具调用）、专注视图（隐藏工具与推理）。
2. 提示输入区：用于输入任务指令，扩展组件可在上下增加小组件。
3. 设置行：左侧展示审批模式、当前模型、推理努力；右侧显示生成速度与上下文占用。
4. 仓库行：当前Git分支与未提交变更数量。
5. 工作区标签页：多工作区场景下显示，附带每个代理运行状态。

基础操作速览

审批模式（安全管控）

默认手动审批模式：代理执行shell命令、文件写入编辑、第三方服务调用前，会暂停并展示调用详情，按1或回车批准，按2拒绝。单纯文件读取、搜索操作无需审批。审批弹窗按Escape可终止本轮全部任务。

支持切换自动审批，代理无需确认直接调用工具，适合已经纳入版本控制、事后统一审查的项目。切换方式：

• F2快捷键
• /approvals 指令
• 启动命令 mirror --approval-mode auto

审批模式配置会全局记住。⚠️ 注意：审批机制不等于沙箱，一旦批准，命令、扩展、MCP服务会以你的账号完整权限运行；代理执行的环境变量会自动剔除REFLECTION_API_KEY这类服务商密钥。

会话管理

每个工作区维持独立对话，操作会自动持久保存，退出不会丢失。

• /clear：清空当前工作区对话，开启新一轮
• /resume：检索恢复历史会话，Tab键切换检索范围（当前目录/整个仓库/全部目录）
• mirror --continue：启动时自动恢复各工作区最近会话
• /rewind：回溯到历史提示，编辑后新建对话分支，原始对话完整保留；回退仅修改对话记录，不会自动撤销文件改动，文件变更需要依靠Git版本控制回滚

要点小结

1. Mirror CLI 是 Beam 模型配套的本地终端编码代理，主打在终端交互式做项目开发，支持多独立工作树并行开发。
2. 提供三层视图、丰富快捷键，会话持久化并支持分支回溯，方便反复调试不同实现方案。
3. 手动审批是核心安全机制，对文件修改、shell命令做人工确认；自动模式适合受版本控制的项目，但是不提供沙箱隔离。
4. 工具以本机账号权限运行，仅自动剥离API密钥；文件回退必须依赖Git，对话回退不会还原代码。