@contentstack/cli

中文文档

2.0.2发布于 2026/10/07MITTypeScriptCommonJS近 30 天下载 4.6万

Command-line tool (CLI) to interact with Contentstack

文档目录6 节

Use Contentstack Command-line Interface (CLI) to interact with Contentstack directly from your terminal.

Requirements

Node.js v22 or higher — download from nodejs.org.

npm install -g @contentstack/cli

csdx --version
csdx --help
csdx auth:login

For complete documentation, visit the Contentstack CLI docs.

Plugin	Description	Docs
`@contentstack/cli-auth`	Authentication — login, logout, token management	Docs
`@contentstack/cli-config`	Region and early-access header configuration	Docs
`@contentstack/cli-cm-import`	Import stacks and modules into Contentstack	Docs
`@contentstack/cli-cm-export`	Export stacks and modules from Contentstack	Docs
`@contentstack/cli-cm-seed`	Seed a stack from a GitHub repository	Docs
`@contentstack/cli-cm-bootstrap`	Bootstrap a new Contentstack project	Docs
`@contentstack/cli-cm-export-to-csv`	Export entries, taxonomies, terms, and org users to CSV	Docs
`@contentstack/cli-cm-clone`	Clone a stack to another stack	Docs
`@contentstack/cli-migration`	Run stack migration scripts	Docs
`@contentstack/cli-cm-branches`	Branch management — create, diff, and merge	Docs
`@contentstack/cli-audit`	Audit and fix content type and entry issues	Docs
`@contentstack/cli-bulk-operations`	Bulk operations across stack content	Docs

These are Contentstack-owned plugins not bundled in the default install. Add any of them with:

csdx plugins:install <plugin-name>

Plugin	Description	Docs
`@contentstack/apps-cli`	Build, deploy, and manage Contentstack apps	Docs
`contentstack-cli-tsgen`	Generate TypeScript typings from a stack's content types	Docs
`contentstack-cli-content-type`	Retrieve and inspect content types in a stack	Docs
`@contentstack/cli-launch`	Deploy and manage Contentstack Launch projects	Docs
`@contentstack/cli-cm-regex-validate`	Validate regex properties on content type and global fields	Docs
`@contentstack/cli-external-migrate`	Migrate content from an external source into Contentstack	—
`@contentstack/cli-cm-export-query`	Export stack content using query filters	Docs

@contentstack/cli 共发布 226 个版本，首次发布于 2020/10/15；过去 12 个月发布了 63 个版本。

其他发布通道：v1-beta → 1.60.0-beta.7，beta → 2.0.0-beta.30，v1-x → 1.69.0。

Command-line tool (CLI) to interact with Contentstack

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

支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

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

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

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

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

最新版本 2.0.2 发布于 2026/10/07（1 个月前）；至今共发布 226 个版本，其中过去 12 个月发布了 63 个；首次发布于 2020/10/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。