Plug CLI

The plugvault command-line interface (CLI) is a powerful tool for managing Claude Code extensions. It features a rich, interactive Terminal User Interface (TUI) for everyday use, while also providing a full suite of traditional CLI commands for automation and CI/CD.

Installation

npm install -g plugvault

🚀 Usage: The Plug TUI (Recommended)

Running plug with no arguments launches the interactive TUI. This is the easiest way to discover, install, and manage your extensions.

plug

Key Interactions:

• Navigate: Use Arrows to move through the package list.
• Search: Press / to focus the search box and filter by name or tags.
• Select: Press Space to toggle package selection for batch operations.
• Install: Press Enter to install your selected packages.
• Tabs: Press Tab to switch between Discover, My Packages, and Vaults.
• Quit: Press q to exit.

Common CLI Commands

For non-interactive use (scripts, CI, etc.), Plug provides the following commands:

init

Initialize the current directory for Plug extensions.

plug init

install

Directly install a package by name. If the package has dependencies, plug resolves and installs them first, then prompts for confirmation (skip with --yes).

plug install code-review
plug install -g my-vault/api-patterns  # Global installation
plug install subagent-driven-development --yes  # Auto-confirm dep plan

If an installed skill declares hook: in its frontmatter, a notice is printed reminding you to add the hook to settings.json.

remove

Uninstall a package.

plug remove code-review
plug remove -g code-review  # Remove from global ~/.claude/
plug remove code-review --yes  # Auto-prune orphaned dependencies without prompting

If other packages depend on the target, plug shows an interactive prompt with three choices:

• Cancel — abort, nothing changes.
• Remove all (cascade) — remove dependent packages first (one level), then remove the target.
• Force remove — remove only the target; severs dependent edges without touching dependent packages.

After any successful remove, plug checks for orphaned auto-installed dependencies. If any exist, it prompts to remove them. --yes skips this confirmation and prunes automatically.

list

List all currently installed packages. Use --remote to see all available packages.

plug list
plug list --remote

update

Check for and apply updates.

plug update --all

vault

Manage package sources.

plug vault list
plug vault add my-vault https://github.com/owner/repo

Advanced: Non-TTY Mode

Plug automatically detects non-interactive environments (like CI) and disables the TUI. Use --json for machine-readable output.

plug list --json

Technical Details

• Global Config: ~/.plugvault/config.json
• Local Tracking: ./.plugvault/installed.json
• Global Tracking: ~/.plugvault/installed.json