终端使用
运行 anda 后,终端 UI 会连接本地 daemon。会话成功完成时,对话会在后台提交给 Brain 形成长期记忆。
输入控制
| 按键 | 作用 |
|---|---|
| Enter | 发送当前消息 |
| Shift+Enter / Ctrl+J | 插入换行 |
| Ctrl+U | 清空输入框 |
| Ctrl+A / Ctrl+E | 跳到输入开头或结尾 |
| Esc | 查看状态 |
| Ctrl+C | 退出 |
输入会保留文本和代码中的空格,光标移动与删除会将组合 emoji 作为一个字符处理。状态检查、对话轮询和 Brain 请求在后台进行,响应较慢时仍可操作界面并按 Ctrl+C 退出。启动界面会保留已有的终端滚动历史。/new 会清空屏幕和滚动历史后开始新对话。重新连接会保留输入草稿,只有恢复到进行中的对话时才替换已显示的记录。在支持 Program Status Protocol(OSC 7501)的终端中,标签页或会话列表会显示 Anda 正在工作、等待你的审批、回答或登录、已完成还是失败;其他终端会忽略它。
修改 ~/.anda/config.yaml 中的模型 provider 后,可以在 Anda 桌面端或浏览器侧边栏点击刷新模型,或运行:
anda models reload
修改仍需要重启的 daemon 设置后,可以输入:
/reload
Slash 命令
| 命令 | 何时使用 |
|---|---|
/goal message | 让一个目标进入长程循环,直到检查结果认为目标完成或需要继续。 |
/loop message | 重复运行 prompt 或 slash 命令;需要间隔时用自然语言写在请求里,省略时让模型自定节奏。 |
/side message 或 /btw message | 开一个旁路子任务,适合临时研究、检查或不想打断主会话的请求。 |
/skill skill-name message | 指定某个运行时 Skill 处理请求。 |
/steer message | 中断接下来的工具调用,并用新指令纠偏当前回复。 |
/stop message | 打断当前任务,取消其后台任务和待审批动作,并清除活动目标。会话回到 idle 状态等待下一条消息;可附带原因。 |
/cancel message | 取消当前活动会话;可附带原因。 |
示例:
/goal 帮我完成这个 release checklist,直到测试和 changelog 都确认通过。
/loop 每5分钟 /side 检查发布队列并总结阻塞项。
/side 查一下这个依赖最近有什么兼容性风险。
/skill git-assistant 帮我整理这次改动的提交说明。
/steer 不要继续重构,先只修复构建错误。
命令审批
有风险的 Shell 命令和 MCP 服务连接会先弹出审批卡片。
| 场景 | 如何回应 |
|---|---|
| 输入框为空 | 按 y 批准,按 n 拒绝。 |
| 输入框中已有内容 | 输入 y/yes 或 n/no 后按 Enter;也可以按 Ctrl+U 清空输入,继续使用单键快捷方式。 |
底部状态栏会提示当前可用的是哪一种。无人回应的卡片会在 10 分钟后过期,对应的工具调用随之失败。
审批卡片会按终端宽度换行,完整展示命令、详情和选项;状态变化会追加到对话记录。提交错误优先于快捷键帮助显示;文字选项提交失败后会保留草稿,方便修改和重试。
Cron 定时任务和自主目标模式(/goal ...)始终以完全访问权限运行:这些场景没有人在旁边回应卡片,否则任务只能等到卡片过期后失败。
常用 CLI 命令
| 命令 | 用途 |
|---|---|
anda | 打开交互式终端 UI。 |
anda --full-access | 打开终端 UI,并对本次会话关闭 Shell 与 MCP 审批卡片。 |
anda update | 更新通过安装脚本安装的发布版。 |
anda status | 查看后台 daemon 是否正在运行。 |
anda start | 启动后台 daemon。 |
anda stop | 停止后台 daemon。 |
anda restart | 重启后台 daemon。 |
anda models reload | 不重启 daemon,从 config.yaml 重新加载模型 provider。 |
anda mcp list | 列出 MCP 服务及其状态、工具数和最近错误;anda mcp --help 介绍如何添加、修改和登录服务。 |
anda autostart status | 查看登录自启是否已注册。 |
anda agent run --prompt "..." | 不打开 UI,直接发起一次请求并等待完整结果。 |
anda voice --record-secs 8 | 启动语音输入;需要配置 transcription。 |
语音播放还需要 tts.enabled: true,并且 PATH 中有音频播放器(ffplay、macOS 的 afplay 或 SoX 的 play),首次录音前会检查。如果只想语音输入、文字输出,可以加 --no-playback。某一轮失败时会提示错误,然后继续下一轮录音。
--prompt 与 --prompt-file 必须且只能提供一个。--wait-timeout-secs 120 限制提交请求与等待完成的总时间;默认 0 表示不设总超时。超时只停止 CLI 等待,daemon 中的任务可能继续运行。
语音模式会等本轮答复完成后再录制下一轮。Ctrl-C 也能停止语音合成和播放。
anda update 和 anda update --skills 会保留较新的本地版本及其附属资源。使用 --force 可明确安装最新发布版,即使它比本地版本旧。
使用 anda memory inbox 读取待办,按输出提示运行 anda memory inbox --cursor <next_cursor> 读取下一页。使用 --json 时,游标位于 result.next_cursor。