# CLI 参考

`agentteam` 命令行用于管理本地守护进程、系统服务生命周期、频道、智能体、技能、诊断、文档和升级。

很多 list/get 命令支持：

```text
--format, -f: table | json | jsonc | yaml | toml
```

## `agentteam connect`

使用浏览器签发的一次性 token 把本机连接到 AgentTeam server。

```bash
agentteam connect --token <token> --server-url <url>
agentteam connect 'agentteam://connect?token=...&origin=https%3A%2F%2Fagentteam.example.com'
```

交换 token 后，该命令会保存 AgentTeam 频道设置，并在需要时启动 daemon。

## `agentteam onboard`

交互式初始化。

```bash
agentteam onboard
agentteam onboard --runtime
```

`--runtime` 会跳过完整向导，只打印 runtime 检测状态和修复建议。它不会安装或升级外部 runtime。

## `agentteam daemon`

以前台方式启动 daemon，或在启动前保存 AgentTeam machine 设置。

```bash
agentteam daemon
agentteam daemon --server-url <url> --api-key <machineApiKey>
agentteam daemon --host 0.0.0.0 --port 9090
agentteam daemon --headless
```

`--headless` 只在 macOS 和 Windows 暴露。Linux daemon 默认 headless。

## `agentteam agent`

查看从远程 AgentTeam 服务器同步到本地的智能体。请在对应的 AgentTeam 服务器中创建、更新或删除智能体。

```bash
agentteam agent list
agentteam agent get <id>
```

`agent list` 和 `agent get` 支持 `--format/-f table|json|jsonc|yaml|toml`。`agent list` 表格输出包含 `ID`、`NAME`、`STATUS`、`RUNTIME`、`MODEL` 和 `SOURCE`；结构化格式通过 `status` 暴露同一份实时或注册状态。daemon 运行时，`status` 来自本机 session 快照；daemon 未运行时，则回退为注册状态。

## `agentteam channel`

管理消息频道。

```bash
agentteam channel list
agentteam channel get <id>
agentteam channel add [name] --agentteam.server-url <url> --agentteam.api-key <key>
agentteam channel update <id> --agent <agent-id>
agentteam channel delete <id>
agentteam channel rm <id>
agentteam channel enable <id>
agentteam channel disable <id>
```

## `agentteam skill`

管理可复用技能文档。

```bash
agentteam skill list
agentteam skill get <id>
agentteam skill import <file-or-url>
agentteam skill import ./skill.md --id skill-id --name "Skill Name"
agentteam skill import ./skills.zip --force
agentteam skill delete <id>
agentteam skill rm <id>
```

支持导入 Markdown 文件、压缩包、远程 URL，以及 GitHub/GitLab 仓库 URL。

## `agentteam service`

安装并管理系统服务。

```bash
agentteam service install
agentteam service uninstall
agentteam service restart
agentteam service reinstall
```

Linux 和 Windows 上还支持：

```bash
agentteam service start
agentteam service stop
```

Linux 上，`install`、`uninstall`、`start`、`stop`、`restart`、`reinstall` 和 `status` 支持 `--user`，用于当前用户的 systemd manager。

## `agentteam status`

显示已安装或正在运行的服务状态。

```bash
agentteam status
agentteam status --user
agentteam status -f json
agentteam status --format yaml
```

Linux 上，普通 `agentteam status` 会同时检查 system 和 user 服务，并显示已安装服务的 active、failed 或 inactive 状态。

status 输出只包含进程与本地 API 信息。它不会签发浏览器登录 URL，也不会暴露
CLI 命令与运行中的 daemon 通信时内部使用的短期凭据。

## `agentteam journal` / `agentteam j`

读取服务日志。

```bash
agentteam journal
agentteam journal --tail 50
agentteam journal --head 20
agentteam journal -f
agentteam j -f --tail 20
```

不带参数时，`agentteam journal` 会输出解析后的日志路径。默认日志文件在 macOS 上是 `~/Library/Logs/agentteam/agentteam.log`，Linux 上是 `${TMPDIR:-/tmp}/agentteam/log/agentteam.log`，Windows 上是 `%LOCALAPPDATA%\agentteam\Logs\agentteam.log`。也可以通过 `config.yaml` 中的 `log.dir` 或 `log.file` 覆盖。

Desktop 仪表盘里的 **AgentTeam 日志** 入口会显示最近 500 条 daemon 日志，并支持复制当前可见日志文本。

## `agentteam doctor`

运行诊断。

```bash
agentteam doctor
agentteam doctor --fix-runtime
```

## `agentteam upgrade`

检查并应用更新。

```bash
agentteam upgrade
agentteam upgrade --check
```

如果当前平台支持自动升级，`agentteam upgrade` 会启动后台升级 helper。

## `agentteam --version`

输出版本信息。

```bash
agentteam --version
agentteam --version -f json
```

## `agentteam doc`

生成 CLI 文档。

```bash
agentteam doc
agentteam doc --man
agentteam doc --man --install
agentteam doc --skill
```

`--man` 与 `--skill` 不能同时使用。