# inkreach-teable-cli

把下面这段引导词发给任意机器 / 任意会话中的 Agent，即可完成安装并开始使用：

```text
请安装并使用 inkreach-teable CLI 操作 inkreach-teable 实例（Teable fork + 自建自动化引擎）：
1. 全局安装 CLI（npm/npx 必须带 git+ 前缀，裸 https 会被当 tarball 下载而报 TAR_BAD_ARCHIVE）：
   npm i -g git+https://gitea.inkreach.cc/inkreachhub/inkreach-teable-cli.git
   免安装用法：npx git+https://gitea.inkreach.cc/inkreachhub/inkreach-teable-cli.git <子命令>
2. 安装 skill 到用户级（这条必须用不带 git+ 的纯 https URL，skills 把 URL 直接传给 git，带前缀会 clone 失败）：
   npx -y skills add https://gitea.inkreach.cc/inkreachhub/inkreach-teable-cli.git -g -y --copy
   会装入 ~/.zcode/skills、~/.claude/skills、~/.agents/skills 等所有 agent 目录（新会话自动加载，当前会话直接阅读该文件）。
3. 配置认证并验证（PAT 从 Web UI Settings → Personal Access Tokens 获取）：
   inkreach-teable auth login --endpoint http://<后端地址> --token <PAT> --base-id bseXXX
   inkreach-teable auth status
4. 使用入口：~/.zcode/skills/inkreach-teable/SKILL.md（模块地图、路由规则、API 参考、实例运维指南）。
   ⚠️ 官方 teable CLI 与本实例自动化契约不兼容（conditions 非 filter、fieldIds 非 watchFieldIds 等），必须用 inkreach-teable。
```