# 04. cfg CLI (配置管理)

## 检查

```bash
# cfg 是否安装
which cfg

# 能否读取配置
cfg list 2>/dev/null | head -5

# 是否有 GITEA_TOKEN
cfg get GITEA_TOKEN
```

✅ 达标：`cfg` 可用，能列出配置项，`GITEA_TOKEN` 有值

## 安装

### 安装 cfg

```bash
# cfg 是家族自建工具，从 Gitea 获取
# macOS
curl -sL "https://git.shazhou.work/shazhou/cfg/releases/download/latest/cfg-darwin-arm64" -o /usr/local/bin/cfg
chmod +x /usr/local/bin/cfg

# Linux (amd64)
curl -sL "https://git.shazhou.work/shazhou/cfg/releases/download/latest/cfg-linux-amd64" -o /usr/local/bin/cfg
chmod +x /usr/local/bin/cfg
```

> ⚠️ 如果上面的下载链接失效，问主人要最新的安装方式。

### 配置

cfg 的配置和 token 由主人提供。安装好后联系主人获取初始配置。

### 重要规则

- Gitea API 用 `cfg env` 的 `GITEA_TOKEN`（每个 agent 自己的）
- **不要**用 osxkeychain 里可能残留的其他人的 token

## 验证

```bash
cfg list
cfg get GITEA_TOKEN
# 应该返回你自己的 token，不是空的
```