跳到主要内容

终端使用

运行 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。