skills/hermes/shazhou-family-onboard/references/02-cfg-cli.md

02. cfg CLI (配置管理)

检查

which cfg
cfg list 2>/dev/null | head -5
cfg get GITEA_TOKEN

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

前置

• 已完成 01 (SSH 密钥对)

安装

1. 安装 cfg

npm install -g @shazhou/cfg

2. 配置 Token

找主人 (沙洲) 要一个 cfg auth token。拿到后：

cfg token 你拿到的TOKEN

Token 会存到 ~/.config/cfg/token。

3. 同步配置

cfg sync

4. 注入环境变量

把 cfg env 加入 .profile，这样每次登录自动注入：

echo 'eval "$(cfg env)"' >> ~/.profile
eval "$(cfg env)"

重要规则

• cfg env 导出所有非 no-env 的配置为环境变量
• cfg set KEY VALUE 写入 personal scope（只有你自己能看到）
• cfg set --shared KEY VALUE 写入 shared scope（所有人可见，需要 admin 权限）
• --secret 标记敏感值，--no-env 标记不需要导出为环境变量的值
• GITEA_TOKEN 是每个 agent 自己的，不要共用

验证

cfg list
cfg get GITEA_TOKEN
# 应该返回你自己的 token