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]

| Option | Description | |---|---| | --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]

| Option | Description | |---|---| | --available | Show all plugins from catalog with install status | | --outdated | Show installed plugins with updates available | | --json | Output 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]

| Option | Description | |---|---| | --force | Reinstall even if already installed | | --verbose | Display each installation step | | --silent | Output 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]

| Option | Description | |---|---| | --force | Skip 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]

| Option | Description | |---|---| | --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]

| Option | Description | |---|---| | --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]

| Option | Description | |---|---| | --force | Skip confirmation prompt | | --verbose | Display command output | | --silent | Output 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]

| Option | Description | |---|---| | --force | Force update even if already on latest version | | --dry-run | Preview what would be updated without making changes | | --verbose | Display each update step | | --silent | Output 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]

| Option | Description | |---|---| | --transport <type> | Transport type: http or stdio (required) | | --scope <scope> | Scope to install into: user, project, or local | | --force | Skip confirmation prompt | | --verbose | Display command output | | --silent | Output 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]

| Option | Description | |---|---| | --scope <scope> | Scope to remove from: user, project, or local | | --force | Skip confirmation prompt | | --verbose | Display command output | | --silent | Output 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]

| Option | Description | |---|---| | -g, --global | Install globally (~/.claude/skills/) | | -s, --skill <names...> | Install only specific skills by name | | -y, --yes | Skip confirmation prompts | | --list | List 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]

| Option | Description | |---|---| | -g, --global | List globally installed skills | | --json | Output 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]

| Option | Description | |---|---| | -g, --global | Remove from global scope | | -f, --force | Skip 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.