@ciandt-flow/cli

中文文档
2.14.1发布于 2026/11/05SEE LICENSE IN LICENSE.mdES Module近 30 天下载 4145

TUI for browsing and installing Claude Code plugins from the Flow ecosystem

原始使用文档
文档目录11 节
  1. Installation
  2. Quick Start
  3. Commands
  4. flow (no arguments)
  5. auth
  6. plugin
  7. mcp
  8. skills
  9. bundle
  10. health
  11. License

flow-plugins-cli

TUI for browsing and installing Claude Code plugins from the Flow ecosystem.

Installation

npm install -g @ciandt-flow/cli

Quick Start

# Authenticate with your Flow credentials
flow auth login

# Launch the interactive plugin browser
flow

Commands

flow (no arguments)

Launches the interactive TUI to browse and manage plugins.


auth

Authentication commands.

auth login

Authenticate and save credentials.

flow auth login [options]
OptionDescription
--client-id <id>Client ID
--client-secret <secret>Client Secret
--tenant <tenant>Tenant
--starter-kit <slug>Starter kit slug to install after authentication

When called without options, enters interactive mode — prompts for each field in the terminal. When called with all three options, runs non-interactively and saves credentials directly.

# interactive mode
flow auth login

# non-interactive mode
flow auth login --client-id <id> --client-secret <secret> --tenant <tenant>

# with starter kit selection
flow auth login --client-id <id> --client-secret <secret> --tenant <tenant> --starter-kit dev

auth logout

Remove saved credentials.

flow auth logout [--force]

auth status

Show current authentication status.

flow auth status

plugin

Plugin management commands.

plugin list

List plugins.

flow plugin list [options]
OptionDescription
--availableShow all plugins from catalog with install status
--outdatedShow installed plugins with updates available
--jsonOutput as JSON
flow plugin list                  # list installed plugins
flow plugin list --available      # list all plugins from catalog
flow plugin list --outdated       # list plugins with updates available
flow plugin list --json           # output as JSON

plugin install <name...>

Install one or more plugins.

flow plugin install <name...> [options]
OptionDescription
--forceReinstall even if already installed
--verboseDisplay each installation step
--silentOutput as JSON only
--marketplace-source <source>GitHub source (owner/repo) for marketplace auto-add when installing external plugins
--scope <scope>Scope to install into: user, project, or local
flow plugin install flow-adr-writer
flow plugin install flow-adr-writer --scope project
flow plugin install flow-adr-writer flow-prd-writer
flow plugin install flow-adr-writer --force
flow plugin install superpowers@claude-plugins-official
flow plugin install agent-sdk-dev@claude-code-plugins --marketplace-source anthropics/claude-code

plugin uninstall <name>

Uninstall a plugin.

flow plugin uninstall <name> [options]
OptionDescription
--forceSkip interactive confirmation
--scope <scope>Scope to uninstall from: user, project, or local
flow plugin uninstall flow-adr-writer
flow plugin uninstall flow-adr-writer --scope project
flow plugin uninstall startup-pack-ai --force

plugin enable <name>

Enable an installed plugin.

flow plugin enable <name> [options]
OptionDescription
--scope <scope>Scope to enable in: user, project, or local
flow plugin enable flow-adr-writer
flow plugin enable flow-adr-writer --scope project

plugin disable <name>

Disable an installed plugin.

flow plugin disable <name> [options]
OptionDescription
--scope <scope>Scope to disable in: user, project, or local
flow plugin disable flow-adr-writer
flow plugin disable flow-adr-writer --scope project

plugin marketplace add <source>

Register a plugin marketplace in Claude Code.

flow plugin marketplace add <source> [options]
OptionDescription
--forceSkip confirmation prompt
--verboseDisplay command output
--silentOutput as JSON only
flow plugin marketplace add anthropics/claude-code
flow plugin marketplace add https://github.com/owner/repo
flow plugin marketplace add anthropics/claude-code --force

plugin update [name]

Update plugins to the latest version. Omit the name to update all installed plugins.

flow plugin update [name] [options]
OptionDescription
--forceForce update even if already on latest version
--dry-runPreview what would be updated without making changes
--verboseDisplay each update step
--silentOutput as JSON only
--scope <scope>Scope to update in: user, project, or local
flow plugin update flow-adr-writer
flow plugin update flow-adr-writer --scope project
flow plugin update                  # update all
flow plugin update --dry-run        # preview only

mcp

MCP server management commands.

mcp add <name> [args...]

Install an MCP server into Claude Code.

flow mcp add <name> [args...] --transport <http|stdio> [options]
OptionDescription
--transport <type>Transport type: http or stdio (required)
--scope <scope>Scope to install into: user, project, or local
--forceSkip confirmation prompt
--verboseDisplay command output
--silentOutput as JSON only
flow mcp add notion --transport http https://mcp.notion.com/mcp
flow mcp add mcp-chrome --transport stdio uvx mcp-chrome
flow mcp add playwright-mcp --transport stdio uvx playwright-mcp --force
flow mcp add notion --transport http https://mcp.notion.com/mcp --scope project

mcp remove <name>

Remove an MCP server from Claude Code.

flow mcp remove <name> [options]
OptionDescription
--scope <scope>Scope to remove from: user, project, or local
--forceSkip confirmation prompt
--verboseDisplay command output
--silentOutput as JSON only
flow mcp remove notion
flow mcp remove notion --scope project
flow mcp remove playwright-mcp --force

skills

Manage skills for Claude Code from GitHub repositories or local paths.

skills add <source>

Install skills from a GitHub repo or local path into Claude Code.

flow skills add <source> [options]
OptionDescription
-g, --globalInstall globally (~/.claude/skills/)
-s, --skill <names...>Install only specific skills by name
-y, --yesSkip confirmation prompts
--listList available skills without installing
flow skills add vercel-labs/agent-skills
flow skills add owner/repo -g
flow skills add owner/repo -s my-skill
flow skills add owner/repo --list
flow skills add ./local/path

skills list

List installed skills.

flow skills list [options]
OptionDescription
-g, --globalList globally installed skills
--jsonOutput as JSON
flow skills list
flow skills list --global
flow skills list --json

skills remove [name]

Remove an installed skill.

flow skills remove [name] [options]
OptionDescription
-g, --globalRemove from global scope
-f, --forceSkip confirmation prompt
flow skills remove my-skill
flow skills remove my-skill --force
flow skills remove --global my-skill

bundle

Manage Flow bundles (Findr use-case collections).

bundle install <name>

Install all artifacts from a Findr bundle in a single operation. Fetches the bundle by name, shows a summary of its artifacts, asks for confirmation, then installs each available artifact sequentially.

flow bundle install <name>
flow bundle install "My React Kit"
flow bundle install "Squad Setup Bundle"

health

Run diagnostic checks.

flow health

License

Copyright (c) CI&T Inc. All rights reserved. See LICENSE.md for details.

版本与发布记录

@ciandt-flow/cli 共发布 161 个版本,首次发布于 2026/04/09;过去 12 个月发布了 161 个版本。

版本发布日期距今
2.14.1latest2026/11/054 天前
2.14.1-beta.76beta2026/11/054 天前
2.14.1-beta.752026/11/054 天前
2.14.1-beta.742026/11/045 天前
2.14.02026/11/036 天前
2.14.0-beta.732026/10/2911 天前

关于 @ciandt-flow/cli 的常见问题

@ciandt-flow/cli 是什么?

TUI for browsing and installing Claude Code plugins from the Flow ecosystem

如何安装 @ciandt-flow/cli?

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

@ciandt-flow/cli 支持 TypeScript 吗?

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

@ciandt-flow/cli 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@ciandt-flow/cli 需要什么版本的 Node.js?

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

@ciandt-flow/cli 可以商用吗?

@ciandt-flow/cli 使用 SEE LICENSE IN LICENSE.md 许可。许可条款写在包内的独立文件中,请阅读该文件确认可否商用。以上为概括,不构成法律意见,请以许可原文为准。

@ciandt-flow/cli 的下载量有多少?

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

@ciandt-flow/cli 还在维护吗?

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