@intentsolutionsio/ccpi

Command-line tool for installing and managing Claude Code plugins from claudecodeplugins.io

Features

• One-Command Installation: Install plugins with a single command
• Universal Compatibility: Works with npm, bun, pnpm, and deno
• Built-in Diagnostics: ccpi doctor checks your Claude Code installation
• Cross-Platform: Supports Linux, macOS, and Windows
• Zero Configuration: Automatically detects Claude Code paths

Installation

You don't need to install this package globally. Just use your preferred package manager:

npm / npx

npx @intentsolutionsio/ccpi install <plugin-name>

Bun

bunx @intentsolutionsio/ccpi install <plugin-name>

pnpm

pnpx @intentsolutionsio/ccpi install <plugin-name>

Deno

deno run -A npm:@intentsolutionsio/ccpi install <plugin-name>

Quick Start

Install a Plugin

npx @intentsolutionsio/ccpi install devops-pack

List Installed Plugins

npx @intentsolutionsio/ccpi list

Run Diagnostics

npx @intentsolutionsio/ccpi doctor

Search for Plugins

npx @intentsolutionsio/ccpi search terraform

Commands

ccpi install <plugin>

Install a plugin from the marketplace.

Options:

• -y, --yes - Skip confirmation prompts
• --global - Install globally for all projects (default: project-local if in a project)

Example:

npx @intentsolutionsio/ccpi install python-pro

ccpi upgrade

Check for and install plugin updates.

Options:

• --check - Check for available updates without upgrading
• --all - Upgrade all plugins with available updates
• --plugin <name> - Upgrade a specific plugin

Examples:

# Check for available updates
npx @intentsolutionsio/ccpi upgrade --check

# Upgrade all plugins
npx @intentsolutionsio/ccpi upgrade --all

# Upgrade a specific plugin
npx @intentsolutionsio/ccpi upgrade --plugin python-pro

Sample Output (Updates Available):

Plugin Upgrade Manager

2 update(s) available:

  python-pro
    Current: 1.0.0 -> Latest: 1.2.0
    Write idiomatic Python code with advanced features

  devops-pack
    Current: 2.1.0 -> Latest: 2.3.0
    Complete DevOps toolchain

To upgrade:

   npx @intentsolutionsio/ccpi upgrade --all
   (Updates all plugins)

   npx @intentsolutionsio/ccpi upgrade --plugin <name>
   (Updates specific plugin)

Version Pinning:

To pin a plugin to a specific version, simply keep the current version installed and don't upgrade. The CLI will continue to show available updates, but you can choose when to upgrade.

ccpi list

List installed plugins.

Options:

• -a, --all - Show all available plugins (not just installed)

Example:

npx @intentsolutionsio/ccpi list --all

ccpi doctor

Run diagnostics on your Claude Code installation and plugins.

Options:

• --json - Output results as JSON

Example:

npx @intentsolutionsio/ccpi doctor

Sample Output:

Claude Code Plugins - System Diagnostics

System Environment:
  Node.js Version: v22.20.0 (supported)
  Operating System: linux 6.8.0-86-generic
  Package Managers: npm, bun

Claude Code Installation:
  Claude Config Directory: /home/user/.claude
  Plugins Directory: /home/user/.claude/plugins
  Marketplaces Directory: /home/user/.claude/marketplaces

Plugins:
  Installed Plugins: 5 total (3 global, 2 local)

Marketplace:
  Marketplace Catalog: Installed
  Catalog Freshness: Up to date

Summary:
  9 passed

All checks passed! Your Claude Code setup is healthy.

ccpi search <query>

Search for plugins in the marketplace.

Example:

npx @intentsolutionsio/ccpi search terraform

Note: Search functionality coming soon. For now, visit claudecodeplugins.io to browse plugins.

ccpi analytics

View plugin usage analytics (Coming Soon).

Options:

• --json - Output as JSON

ccpi marketplace

Manage marketplace connection and setup.

Options:

• --verify - Verify marketplace installation and show detailed status

Example:

# Check marketplace status
npx @intentsolutionsio/ccpi marketplace

# Verify installation with detailed diagnostics
npx @intentsolutionsio/ccpi marketplace --verify

Sample Output (Not Installed):

Claude Code Plugins Marketplace

Marketplace not added yet

Setup Instructions:

1. Open Claude Code (terminal or desktop app)
2. Run this command:

   /plugin marketplace add jeremylongshore/claude-code-plugins

3. Wait for confirmation (usually < 5 seconds)
4. Verify installation:

   npx @intentsolutionsio/ccpi marketplace --verify

Sample Output (Installed):

Claude Code Plugins Marketplace

Marketplace is already added!

Marketplace Status:

Installation:
  Marketplace added
  Location: /home/user/.claude/marketplaces/claude-code-plugins-plus

  Catalog found
  File: /home/user/.claude/marketplaces/claude-code-plugins-plus/.claude-plugin/marketplace.json

ccpi marketplace-add

Guide you through adding the marketplace to Claude Code.

Example:

npx @intentsolutionsio/ccpi marketplace-add

ccpi marketplace-remove

Guide you through removing the marketplace from Claude Code.

Example:

npx @intentsolutionsio/ccpi marketplace-remove

Package Manager Performance

| Package Manager | Startup Time | Market Share | |----------------|--------------|--------------| | Bun (bunx) | ~0.05s | ~5% | | Deno | ~0.1s | ~5% | | pnpm (pnpx) | ~0.5s | ~10% | | npm (npx) | ~2-5s | ~80% |

Recommendation: For fastest performance, use bunx if you have Bun installed.

Configuration

No configuration required! The CLI automatically:

• Detects your Claude Code installation directory
• Finds your global plugins directory (~/.claude/plugins)
• Detects project-local plugins (.claude-plugin/ directory)
• Creates necessary directories if they don't exist

Supported Paths

Linux & macOS:

• Config: ~/.claude
• Plugins: ~/.claude/plugins
• Marketplaces: ~/.claude/marketplaces

Windows:

• Config: %APPDATA%\Claude
• Plugins: %APPDATA%\Claude\plugins
• Marketplaces: %APPDATA%\Claude\marketplaces

Requirements

• Node.js 18.0.0 or higher
• Claude Code installed and run at least once

Troubleshooting

"Claude Code config directory not found"

Ensure Claude Code is installed and has been run at least once. The CLI looks for:

• Linux/macOS: ~/.claude
• Windows: %APPDATA%\Claude

Run ccpi doctor to diagnose installation issues.

Permission Errors

If you get permission errors during installation:

1. Try installing locally (project-level) instead of globally
2. Check that you have write permissions to the Claude directories
3. Run ccpi doctor to check your setup

Plugin Not Found

If a plugin can't be found:

1. Check the plugin name spelling
2. Run ccpi list --all to see available plugins
3. Visit claudecodeplugins.io to browse the full marketplace
4. Ensure your marketplace catalog is up to date

Development

Setup

npm install
npm run build

Testing

npm test

Build

npm run build

This compiles TypeScript to JavaScript in the dist/ directory.

Architecture

The CLI is built with:

• Commander.js - CLI framework
• Chalk - Terminal styling
• Ora - Loading spinners
• fs-extra - File system operations
• axios - HTTP requests

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT (c) Intent Solutions IO

Links

• Website: claudecodeplugins.io
• GitHub: jeremylongshore/claude-code-plugins
• Issues: GitHub Issues
• Marketplace: Browse Plugins

Built with love for the Claude Code community