Agy Client & Command Reference
AGY 终端命令与参数指南
TL;DR / 核心速览
本文档收录了 agy 客户端的所有命令行选项（Flags）、管理维护子命令（Subcommands）以及交互式会话中的斜杠命令（Slash Commands）。点击任何命令或示例代码块，即可直接将其复制到剪贴板。
/goal
深度对齐目标
启动后台自适应任务循环。Agent 将处于高度自主状态，持续在后台寻找解决方案、验证输出并解决报错，直到达成设定目标。
推荐场景：适合长耗时、高难度的自动化开发任务，比如自动写完测试并跑通、一键构建项目并排除全部编译报错。
/goal 重构 main.go 并修复所有 lint 报错
/grill-me
方案拷问对齐
强制 Agent 开启交互式提问（拷问）模式。它将不主动执行修改，而是针对你的设计构想从安全、扩展性、边缘漏洞等方向向你连环提问。
推荐场景：需求分析与架构设计阶段，用以理清思路、发现漏洞。
/grill-me 我准备把数据库迁移到 PostgreSQL 数据库
/schedule
定时与周期任务
创建一个单次后台定时器，或者按照 Cron 表达式设定一个长期的后台监控计划。触发时会以高优先级唤醒 Agent。
推荐场景：监控、定时任务、延时提醒。例如定时跑一次健康检查。
/schedule "*/15 * * * *" "运行单元测试，如果失败则发出警报"
/model
切换 AI 模型
查看当前会话的 AI 模型配置，或者直接在轻量级模型与多功能旗舰版模型之间进行切换。
推荐场景：处理繁重的重构、复杂算法或编写关键设计文档时切到 Pro 模型；进行简单搜寻、一问一答时使用 Flash。
/model Gemini 3.5 Pro (Large)
/clear
重置会话上下文
清除终端显示，并彻底斩断之前的会话上下文历史。AI 会忘掉过去发生的事，进入全新纯净的问答模式。
推荐场景：之前的对话已经进行了太长，导致上下文垃圾信息过多、响应变慢；或者彻底调转方向进入新的研发主题时。
/clear
/exit
安全关闭会话
优雅安全地退出当前
agy 的交互式会话模式，等同于按下快捷键 Ctrl + D。
/exit
agy -c
继续上一次会话
继续上次因退出或网络断开而挂起的最近一次会话，保留之前的所有上下文与工作区授权。
推荐场景：中断工作后想继续，省去重新解释上下文的步骤。
agy --continue
agy --conversation
根据ID恢复会话
根据指定的 Conversation ID（如：
b0523c91...），强行加载并拉回历史上的某个特定会话状态。
推荐场景：需要回到昨天甚至上周的特定工程环境进行追加修复或跟进任务时。
agy --conversation b0523c91-e82b-4085-8543-d1c9e3a7021e
agy -p
单次执行并打印
在非交互模式下直接对 Agent 发送一条指令。Agent 将直接计算输出、修改代码并将其打印输出在屏幕上，随后结束进程，不驻留 Shell。
推荐场景：需要一键批处理，或将其写进你本地的 Shell 自动化脚本（Bash scripts）时。
agy --print "将项目下的 README.md 里的内容转换为中文"
agy --add-dir
添加关联目录
在启动 `agy` 时强行挂载一个或多个外部文件夹。这允许 Agent 在不离开当前工程目录的同时，具备对该外部目录的代码读写和检索权限。
推荐场景：你的当前项目依赖于另外一个本地私有库，而你需要 Agent 协同修改这两个仓库的代码时。
agy --add-dir /Users/shane/code/another-library
--dangerously-skip...
免确认自动授权
开启后，Agent 发起的所有需要用户审核的终端命令（如
git, npm, brew 或者是写文件操作）都将**不提示确认而直接执行**。
推荐场景：仅在你完全信任项目背景代码、正在进行全自动化的批处理（如 `/goal`）且不想不断敲键盘回车时使用。
agy --dangerously-skip-permissions --print "一键构建并部署"
agy --sandbox
沙盒受限模式
强行在严格受限的沙盒环境中启动。Agent 在此模式下仅具备对工作区目录的安全读写，所有的破坏性敏感命令或外部网络请求都会被自动拦截。
agy --sandbox
agy plugin
插件生命周期管理
管理当前客户端挂载的 Model Context Protocol (MCP) 以及本地插件生态。支持安装、卸载、列表列出以及启用/禁用。
典型子命令：
list (显示所有已装插件)、
install <url/dir> (配置并安装新插件)、
enable/disable <name> (快速停用插件)。
agy plugin list # 查看当前已加载的 MCP 插件列表
agy install
系统路径与补全配置
自动将
agy 注册到全局系统的 PATH 环境变量中，并在本地配置 shell（如 zsh/bash）自动补全设置。
推荐场景：首次安装或将终端从 bash 迁移至 zsh 时，一键恢复
agy 的快速补全支持。
agy install
agy update
一键升级客户端
连接官方升级通道，下载并覆盖更新你当前 Mac 系统中的
agy 命令行客户端程序。
agy update
agy changelog
查看版本发布日志
拉取并本地渲染最近的版本发布历史和新特性更新说明。
agy changelog
🛠️ AI 视角解密：斜杠命令与 CLI 运行机制
1. /goal 状态机驱动
当在终端输入 /goal <目标> 时，agy 客户端并不会只进行单次的推理。它会启动一个守护进程（Daemon Session），将任务转入后台。Agent 会在后台不断运行 PLAN -> EXECUTE -> VERIFY 闭环，不断根据测试反馈调整方案，除非成功率达到阈值或者由于外部原因人工中止，否则状态机将自适应重试。
2. /grill-me 的双向对齐逻辑
该命令旨在突破单向接收指令的限制。它会暂时关闭 Agent 的自动执行功能，启用 Elicitation mode（需求召回模式）。它会将背景逻辑分解为“输入不确定性”、“技术架构选型”以及“破坏性变更可能性”三个维度，通过交互问答迫使用户补充工程细节。
3. /schedule 的后台任务总线
此命令在本地的 agentapi 服务中注册一个轻量级定时任务列表。定时任务独立于交互 session 之外。一旦定时触发，它会唤起一个新的隐式会话并下发对应的 prompt。这就是为什么即便你关闭了当前的会话终端，后台定时任务仍可能向你弹送通知。