CLI 界面

anyy 是 Anyy 唯一的命令行入口。不带参数运行时会打开交互式终端应用；带子命令运行时则执行一次性操作 —— 发送提示词、查看状态、管理网关、配置供应商与频道等。

本页是日常使用的总览：如何调用 CLI、全局标志放在哪里，以及各命令组的用途。若需要逐命令的完整标志表，请参阅 CLI 命令参考。

运行 CLI

安装后 anyy 已经在你的 PATH 中。先确认构建版本：

anyy --version

Anyy (anyy) version v0.1.57 channel stable commit 8627a748340f built 2026-06-15T08:03:45Z

不带参数运行可启动默认的交互式 TUI；带命令运行则执行单次操作后退出：

anyy                 # 交互式终端应用
anyy status          # 一次性：打印状态摘要
anyy --help          # 完整用法与命令列表

命令模式

CLI 有三种模式，由二进制名之后跟随的内容（如果有）来区分。

默认交互式 TUI

不带命令运行 anyy 会启动常驻终端应用 —— 一个长期运行的会话界面，支持流式回复、斜杠命令与审批。这是交互式工作的主要界面，详见 TUI 页面。

anyy
anyy --role assistant         # 以指定 Role 开启新会话
anyy --resume SESSION_ID      # 重新打开已有会话

TUI 与常驻的网关通信。如果没有正在运行的网关，应用会帮助你启动一个 —— 参见网关页面。

一次性 chat

anyy chat 通过正在运行的网关发送单条提示词并打印回复，然后退出。它是 TUI 的脚本与管道友好版对应物。

anyy chat "summarize my unread mail"
anyy chat --json --yes "what's on my calendar today"

chat 需要一个正在运行的网关。没有网关时会给出清晰的修复提示：

✗ Could not create chat session

Reason:
  dial unix /…/anyy.sock: connect: no such file or directory

Next:
  start Anyy gateway, then run anyy chat again

关于 Role 选择、审批、流式输出、JSON 模式与退出码，请参阅 Chat。

管理命令

其余每个子命令都执行一项聚焦的管理操作后退出 —— 管理网关、配置供应商与频道、检查健康状况、运行维护任务等。anyy --help 会列出全部命令；它们大致分为几组：

分组	命令	用途
对话	`chat`、（默认 TUI）	发送提示词或打开交互式会话。
运行时	`gateway`、`dashboard`、`heartbeat`	启动/停止常驻网关与仪表盘边车；查看心跳。
健康	`status`、`doctor`	打印状态摘要或运行诊断检查。
配置	`setup`、`config`、`update`、`uninstall`	运行配置向导、查看配置、更新二进制或移除安装。
身份	`profile`、`role`	管理 profile 与 Role。
频道	`channels`	配置（`setup channels`）并重载消息平台。
扩展	`skills`、`mcp`、`computer-use`、`browser`	安装技能、管理 MCP 服务器，以及切换 computer-use / browser 能力。
调度	`cron`	管理计划任务。
数据	`backup`、`maintenance`、`memory`	创建备份、运行状态维护，并手动预览或应用记忆整理。

每个命令都有自己的 --help。例如网关组：

$ anyy gateway --help
Usage:
  anyy gateway start [--home PATH]
  anyy gateway restart [--home PATH]
  anyy gateway status [--home PATH]
  anyy gateway stop [--home PATH]

Manages the resident Anyy Gateway background service.

……而配置组则汇集了各个配置向导：

$ anyy setup --help
Interactive wizard to configure provider, model, messaging, and optional capabilities.

Usage:
  anyy setup [--home PATH]            full wizard
  anyy setup model [--home PATH]      provider/auth/default model
  anyy setup aux [--home PATH]        optional capabilities
  anyy setup channels [--home PATH]   messaging platforms only
  …

每个命令的完整标志表见 CLI 命令参考。

全局标志

全局标志用于配置 profile、Role 与渲染，并且必须出现在命令之前。它们由顶层二进制解析，而非由各个子命令解析：

标志	用途
`--profile NAME`	按名称选择 Anyy profile。
`--profile-root PATH`	使用非默认的 profile 根目录。
`--role ROLE`	为新会话选择初始 Role。
`--no-color`	禁用彩色输出。
`--version`	打印版本信息后退出。
`--help`、`-h`	打印用法与命令列表。

由于它们是顶层标志，因此要放在子命令之前：

anyy --no-color status        # ✓ 全局标志在前
anyy --profile work chat "hi" # ✓

把全局标志放在命令之后会被拒绝，因为子命令并未重新定义它：

$ anyy status --no-color
✗ Invalid status arguments

Reason:
  flag provided but not defined: -no-color

有少数标志仅属于默认 TUI 入口 —— --home、--socket 和 --resume。它们为交互式应用选择主目录、网关套接字与会话，且仅在不带命令时有效：

anyy --home /path/to/home --resume SESSION_ID

备注

大多数子命令在命令之后接受其自身的 --home、--socket 与 --json 标志（例如 anyy status --home PATH --json）。这些是命令标志，而非全局标志，且 --profile 与命令的 --home 不能同时设置。各命令接受哪些标志，请参阅 CLI 命令参考。

斜杠命令

斜杠命令（/help、/model、/new、/resume、/compact ……）是在交互式 TUI 内部输入的，而非在 shell 命令行上。它们用于引导实时会话：切换模型或 Role、管理会话、审阅审批与变更计划等。

/help        list available slash commands
/model       switch the active model
/new         start a fresh session
/resume      reopen a previous session

完整列表及每个命令的作用，请参阅斜杠命令参考。关于如何在具体场景中使用它们，请参阅 TUI 页面。

多行输入

多行输入是交互式 TUI 的功能：可以用 TUI 的输入按键撰写跨多行的提示词。关于具体按键请参阅 TUI 页面；当前构建使用 Alt+Enter、Ctrl+J，或在行尾输入反斜杠后按 Enter 来插入换行。

对于一次性的 anyy chat 命令，将整条提示词作为单个带引号的参数传入即可 —— 引号内的换行会被保留：

anyy chat "first line
second line"

中断与引导

在交互式 TUI 中，你可以中断正在进行的回复并在任务中途引导智能体； TUI 页面介绍了中断按键与引导流程。

一次性的 anyy chat 运行可像任何前台命令一样中断 —— 按 Ctrl-C 取消并返回 shell。

会话

对话会以会话的形式持久化，便于你从上次中断处继续。会话由网关拥有，并在各个界面间共享；会话页面是完整指南。

按 ID 恢复

在 shell 中，按 ID 在 TUI 里重新打开某个会话：

anyy --resume SESSION_ID

若要在单次一次性提示词中继续某个特定会话，向 chat 传入 --session：

anyy chat --session SESSION_ID "and what about tomorrow?"

--resume 不能与 --role 同时使用，因为被恢复的会话已经带有其 Role。

从 TUI 恢复

在交互式应用内部，使用 /resume 斜杠命令即可浏览并重新打开近期会话而无需离开 TUI，或使用 /new 开启全新会话。参见 TUI 页面。

会话存储

会话与其他状态保存在 Anyy 的主目录下，由网关管理。 anyy status 会报告当前生效的主目录：

$ anyy status
◆ Anyy status
  Gateway             stopped
  Profile             default
  Default role        default
  Home                /…/home
  Timezone            Asia/Shanghai (host)

用 --home PATH 可为单条命令覆盖主目录（对于 TUI 入口，则用 anyy --home PATH）。磁盘布局与保留策略请参阅会话。

JSON 输出

报告数据的命令接受 --json 以输出机器可读结果，便于把结果管道传给脚本和其他工具。将 --json 放在命令之后：

anyy status --json

{
  "home": "/…/home",
  "profile": "default",
  "default_role": "default",
  "timezone": "Asia/Shanghai",
  "gateway": "stopped",
  "active_sessions": 0,
  …
}

--json 由报告与列表类命令支持 —— 例如 status、doctor、chat、 profile list、role list、skills list、mcp list 以及 cron list。哪些命令接受它，见 CLI 命令参考。对于 chat，Chat → JSON Mode 介绍了事件结构。

故障排查

anyy chat 提示无法创建会话 —— 网关没有运行。用 anyy gateway start 启动它后重试。参见网关。
某个全局标志「未定义」 —— 你把它放在了命令之后。请把 --profile、 --profile-root、--role 或 --no-color 移到命令之前（例如 anyy --no-color status）。
「profile and home cannot both be set」 —— --profile 与命令的 --home 互斥；二者只用其一。
常规诊断 —— 运行 anyy doctor 进行配置与连通性检查，运行 anyy status 查看实时摘要。参见状态与 Doctor 与故障排查参考。

运行 CLI​

命令模式​

默认交互式 TUI​

一次性 chat​

管理命令​

全局标志​

斜杠命令​

多行输入​

中断与引导​

会话​

按 ID 恢复​

从 TUI 恢复​

会话存储​

JSON 输出​

故障排查​