AgentStash 内置了命令行工具（ags），可直接从桌面端一键安装，之后在终端中即可完成同步、配置管理，以及通过 Hub 安装和分发 AI 技能。
打开 AgentStash 桌面端 → 设置 → 点击 Install CLI。这会将 ags 二进制文件复制到 ~/.agents/bin/，并自动写入你 shell 的 PATH。
| 命令 | 说明 |
|---|
ags push [RESOURCE_ID...] | 将本地更改推送到同步目录。加 --force 可清除状态后全量推送。 |
ags pull [RESOURCE_ID...] | 从同步目录拉取更改到本地。加 --force 可清除状态后全量拉取。 |
ags status | 显示同步状态和待处理的变更预览。可用 --direction push|pull。 |
ags resources | 列出所有已发现的资源。可用 --provider <ID> 过滤。 |
ags diff <RESOURCE_ID> | 显示指定资源的差异对比。 |
ags discard <RESOURCE_ID> | 丢弃指定资源的本地更改。需指定 --action。 |
| 命令 | 说明 |
|---|
ags config show | 显示当前配置。 |
ags config set-sync-dir <PATH> | 设置同步目录路径。 |
ags config get-sync-dir | 获取当前同步目录路径。 |
ags config list-providers | 列出所有 Provider。 |
| 命令 | 说明 |
|---|
ags backup create [PROVIDER_ID...] | 创建新备份。不指定则备份所有 Provider。 |
ags backup list | 列出所有备份。 |
ags backup restore <BACKUP_ID> | 从指定备份恢复。 |
ags backup delete <BACKUP_ID> | 删除指定备份。 |
hub 子命令集用于管理技能仓库——克隆、安装、将技能分发到你的 AI 工具，并内置冲突检测。
| 命令 | 说明 |
|---|
ags hub add <NAME> <SOURCE> <PATH> | 注册新的 Hub 仓库。SOURCE 为 Git URL，PATH 为仓库内 .agents 资源的相对路径。 |
ags hub install <NAME> | 克隆已注册的仓库到本地。 |
ags hub update [--all | <NAME>] | 拉取已安装仓库的最新更改。 |
ags hub remove <NAME> | 移除仓库注册、删除本地克隆，并从所有 Provider 中级联卸载其技能。 |
ags hub distribute | 将所有已安装仓库的技能分发到各 Provider 配置目录（.cursor、.claude 等）。遇到同名冲突会自动跳过。 |
ags hub status | 列出所有已注册仓库及其安装状态和当前注入的技能。 |
| 选项 | 说明 |
|---|
--format text|json | 输出格式（默认：text）。 |
-v, --verbose | 启用详细输出。 |
--test-env <DIR> | 使用指定目录作为 HOME（用于沙箱测试）。 |
