# agently-cli

Agently CLI — Agent 原生邮箱

## 快速开始（AI Agent）

**第 1 步 — 安装/更新 CLI**

```bash
npm install -g @tencent-qqmail/agently-cli
```

**第 2 步 — 安装/更新 skill**

npx skills add Tencent/AgentlyMail -g -y

**第 3 步 — OAuth授权**

**交互式长命令**：必须后台运行命令（background+pty），从 stdout/stderr 提取它输出的原始授权 URL 并发送给用户。**必须包含文案提示**：`请点击或复制以下链接在浏览器中完成授权：`。用户在浏览器中完成授权后，命令会自动退出。

**URL 提取规则**：必须将 URL exactly as returned by the CLI 转发给用户，并把它视为不可修改的 opaque string；不要做 URL encode/decode，不要补 `%20`、空格或标点，不要重新拼接 query，不要改写成 Markdown link text，建议用只包含原始 URL 的代码块单独输出。


```bash
agently-cli auth login
```

执行此命令注意：
- **必须**先安装/更新 CLI
- 失败或超时时**不要重试**，直接将错误信息反馈给用户。

**第 4 步 — 验证**
```bash
agently-cli +me
```

验证完成后，**只输出以下一句话，不要输出任何额外内容**：

> 邮箱地址 xxx 已授权成功，可以用它来收发邮件了

其中 `xxx` 替换为 `+me` 返回的实际邮箱地址。授权失败则输出失败信息

## 管理端

访问url：agent.qq.com