@cnbcool/cnb-cli

中文文档
1.19.20发布于 2026/11/10MITCommonJS零依赖近 30 天下载 12.4万

CNB OpenAPI 命令行工具,基于 CNB 平台 Swagger 自动生成,支持 Issues、PR、Git、组织管理等全部 API 操作

原始使用文档
文档目录9 节
  1. 快速开始
  2. 更多安装方式
  3. 前置依赖
  4. AI 安装提示词
  5. 环境变量
  6. cnb git-credential
  7. 1. 登录
  8. 2. 配置 Git
  9. 3. 使用 HTTPS 操作

CNB Skills

CNB 平台技能集合,支持多种主流 Agent,通过 npx skills 一键安装。

快速开始

# 推荐:全局安装所有 Skills,对所有 Agent 生效
npx skills add https://cnb.cool/cnb/skills/cnb-skill.git -g -y

安装后所有 CNB Skills 即可在任意 Agent 中使用。

更多安装方式

# 安装到指定 Agent(如 CodeBuddy;不指定 --agent 时自动检测并提示选择)
npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --agent codebuddy -y

# 同时安装到多个 Agent
npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --agent codebuddy --agent claude-code -y

# 安装到所有支持的 Agent
npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --agent '*' -y

# 只安装指定 Skill(先用 --list 查看可安装项)
npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --list
npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --skill cnb-api --agent codebuddy -y

前置依赖

使用 npx skills 需要安装 cnb-cli:

# macOS / Linux
curl -fsSL https://cnb.cool/cnb/skills/cnb-skill/-/git/raw/main/install.sh | sh

# Windows PowerShell
irm https://cnb.cool/cnb/skills/cnb-skill/-/git/raw/main/install.ps1 | iex

# npm
npm install @cnbcool/cnb-cli -g

也可前往 Releases 手动下载。

AI 安装提示词

将以下内容发送给 Agent 即可自动安装;按需替换 --agent 参数:

npm install @cnbcool/cnb-cli -g
npm install skills -g
npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --agent codebuddy -y --copy

环境变量

必填

  • CNB_TOKEN:访问凭证
  • CNB_API_ENDPOINT:API 端点,如 https://api.cnb.cool

可选

  • CNB_BRANCH:默认分支
  • CNB_SSL_NO_VERIFY:设为 true 跳过 HTTPS 证书校验,适用于自签证书或私有化部署。仅作用于 cnb 自身请求,git 的 clone/push 需另配 http.sslVerify=false

cnb git-credential

cnb git-credential 可作为 Git Credential Helper,为 HTTPS 操作自动提供 CNB 访问凭据。

1. 登录

cnb login

2. 配置 Git

git config --global credential.https://cnb.cool.helper ""
git config --global credential.https://cnb.cool.helper "!cnb git-credential"
git config --global credential.https://cnb.cool.useHttpPath true

3. 使用 HTTPS 操作

git clone https://cnb.cool/<org>/<repo>.git
cd <repo>
git pull
git push

凭据来源优先级:CodeBuddy 环境 token → CNB_TOKEN 环境变量 → ~/.cnb/token 登录凭据。

版本与发布记录

@cnbcool/cnb-cli 共发布 287 个版本,首次发布于 2026/03/25;过去 12 个月发布了 287 个版本。

版本发布日期距今
1.19.20latest2026/11/10今天
1.19.192026/11/10今天
1.19.182026/11/10今天
1.19.172026/11/10今天
1.19.162026/11/10今天
1.19.152026/11/10今天

关于 @cnbcool/cnb-cli 的常见问题

@cnbcool/cnb-cli 是什么?

CNB OpenAPI 命令行工具,基于 CNB 平台 Swagger 自动生成,支持 Issues、PR、Git、组织管理等全部 API 操作

如何安装 @cnbcool/cnb-cli?

在项目目录运行 npm install @cnbcool/cnb-cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 cnb,可以用 npx cnb 直接运行。

@cnbcool/cnb-cli 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/cnbcool__cnb-cli 是否存在。

@cnbcool/cnb-cli 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@cnbcool/cnb-cli 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@cnbcool/cnb-cli 可以商用吗?

@cnbcool/cnb-cli 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@cnbcool/cnb-cli 的下载量有多少?

根据 npm 官方下载统计,@cnbcool/cnb-cli 在 2026/10/10 – 2026/11/08 这 30 天内被下载 124,217 次,日均约 4,141 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@cnbcool/cnb-cli 还在维护吗?

最新版本 1.19.20 发布于 2026/11/10(今天);至今共发布 287 个版本,其中过去 12 个月发布了 287 个;首次发布于 2026/03/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。