copilot-plugin-manager 0.1.1

Python-first GitHub Copilot plugin, skill, and agent manager

copilot-plugin-manager

A Python-first CLI for managing GitHub Copilot plugins, skills, and agents.

It keeps Copilot setup management focused and reproducible:

• compose setups from profiles and themes
• install, update, and prune plugins
• sync local skills and agents into ~/.copilot
• track repository-aware state under ~/.copilot/copilot-plugin-manager
• refresh bundled catalogs from curated upstream sources

Install

Install the CLI into your current Python environment:

pip install copilot-plugin-manager

Or run it without installing anything permanently:

uvx copilot-plugin-manager --help

Once installed with pip, the command is available directly:

copilot-plugin-manager --help

Quick start

List what is available:

copilot-plugin-manager list profiles
copilot-plugin-manager list themes
copilot-plugin-manager list sources

Activate a setup for the current repository:

copilot-plugin-manager switch python-core
copilot-plugin-manager switch-exclusive python-mcp

Refresh upstream sources and inspect state:

copilot-plugin-manager repo-update --remote
copilot-plugin-manager status

If you prefer one-off execution with uvx, the same commands work there too:

uvx copilot-plugin-manager list profiles
uvx copilot-plugin-manager status

uvx is convenient for direct execution, but persistent shell completion is easiest when the CLI is installed locally.

Shell completion

Quick shell-init snippets:

copilot-plugin-manager shell-init bash
copilot-plugin-manager shell-init zsh
copilot-plugin-manager shell-init fish
copilot-plugin-manager shell-init powershell
copilot-plugin-manager shell-init nushell

Managed completion files:

copilot-plugin-manager completion-install fish
copilot-plugin-manager completion-install bash
copilot-plugin-manager completion-script powershell

From source

If you want to run the project from a local checkout instead of installing it from PyPI:

git submodule update --init --recursive
uv sync --group dev
uv run copilot-plugin-manager --help

Documentation

Document	Purpose
docs/USAGE.md	Managed content, state model, command reference, and shell setup.
CONTRIBUTING.md	Local development setup, test/lint/build commands, and PR workflow.
docs/RELEASING.md	Build, TestPyPI, and PyPI publishing flow.
SECURITY.md	Vulnerability reporting and supported versions.
CODE_OF_CONDUCT.md	Community expectations and reporting guidance.
LICENSE	Project license terms.

Project links

• PyPI package: https://pypi.org/project/copilot-plugin-manager/
• CI/CD workflow: https://github.com/Anselmoo/copilot-plugin-manager/actions/workflows/cicd.yml
• Catalog refresh workflow: https://github.com/Anselmoo/copilot-plugin-manager/actions/workflows/catalog-refresh.yml
• Security policy: https://github.com/Anselmoo/copilot-plugin-manager/security/policy
• Issue tracker: https://github.com/Anselmoo/copilot-plugin-manager/issues