copilot-plugin-manager 0.1.0__tar.gz

copilot_plugin_manager-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anselm Hahn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

copilot_plugin_manager-0.1.0/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: copilot-plugin-manager
+Version: 0.1.0
+Summary: Python-first GitHub Copilot plugin, skill, and agent manager
+Keywords: github-copilot,copilot,cli,plugin-manager,skills,agents
+Author: Anselm Hahn
+Author-email: Anselm Hahn <Anselm.Hahn@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Version Control
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Requires-Dist: pydantic>=2,<3
+Requires-Dist: rich>=14.3.3
+Requires-Dist: typer>=0.24.1
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/Anselmoo/copilot-plugin-manager
+Project-URL: Repository, https://github.com/Anselmoo/copilot-plugin-manager
+Project-URL: Issues, https://github.com/Anselmoo/copilot-plugin-manager/issues
+Description-Content-Type: text/markdown
+
+# copilot-plugin-manager
+
+[![CI](https://img.shields.io/github/actions/workflow/status/Anselmoo/copilot-plugin-manager/cicd.yml?branch=main&label=ci)](https://github.com/Anselmoo/copilot-plugin-manager/actions/workflows/cicd.yml)
+[![PyPI publish](https://img.shields.io/badge/publish-PyPI-blue)](https://github.com/Anselmoo/copilot-plugin-manager/actions/workflows/cicd.yml)
+[![PyPI version](https://img.shields.io/pypi/v/copilot-plugin-manager)](https://pypi.org/project/copilot-plugin-manager/)
+[![Python versions](https://img.shields.io/pypi/pyversions/copilot-plugin-manager)](https://pypi.org/project/copilot-plugin-manager/)
+[![License](https://img.shields.io/github/license/Anselmoo/copilot-plugin-manager)](LICENSE)
+
+A Python-first GitHub Copilot plugin manager built with `Typer`, `Rich`, and `Pydantic`.
+
+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 from source
+
+```bash
+git submodule update --init --recursive
+uv sync --group dev
+uv run copilot-plugin-manager --help
+```
+
+The default invocation also works:
+
+```bash
+uv run copilot-plugin-manager
+```
+
+## Quick start
+
+List what is available:
+
+```bash
+uv run copilot-plugin-manager list profiles
+uv run copilot-plugin-manager list themes
+uv run copilot-plugin-manager list sources
+```
+
+Run a one-off command straight from your terminal with `uvx`:
+
+```bash
+uvx copilot-plugin-manager list profiles
+```
+
+`uvx` is convenient for direct execution, but persistent shell completion is easier when the CLI is installed locally or run from a checked-out repository with `uv run`.
+
+Activate a setup for the current repository:
+
+```bash
+uv run copilot-plugin-manager switch python-core
+uv run copilot-plugin-manager switch-exclusive python-mcp
+```
+
+Refresh upstream sources and inspect state:
+
+```bash
+uv run copilot-plugin-manager repo-update --remote
+uv run copilot-plugin-manager status
+```
+
+## Shell completion
+
+Quick shell-init snippets:
+
+```bash
+uv run copilot-plugin-manager shell-init bash
+uv run copilot-plugin-manager shell-init zsh
+uv run copilot-plugin-manager shell-init fish
+uv run copilot-plugin-manager shell-init powershell
+uv run copilot-plugin-manager shell-init nushell
+```
+
+Managed completion files:
+
+```bash
+uv run copilot-plugin-manager completion-install fish
+uv run copilot-plugin-manager completion-install bash
+uv run copilot-plugin-manager completion-script powershell
+```
+
+## Documentation
+
+| Document | Purpose |
+| --- | --- |
+| [`docs/USAGE.md`](docs/USAGE.md) | Managed content, state model, command reference, and shell setup. |
+| [`CONTRIBUTING.md`](CONTRIBUTING.md) | Local development setup, test/lint/build commands, and PR workflow. |
+| [`docs/RELEASING.md`](docs/RELEASING.md) | Build, TestPyPI, and PyPI publishing flow. |
+| [`SECURITY.md`](SECURITY.md) | Vulnerability reporting and supported versions. |
+| [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md) | Community expectations and reporting guidance. |
+| [`LICENSE`](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>

copilot_plugin_manager-0.1.0/README.md

@@ -0,0 +1,102 @@
+# copilot-plugin-manager
+
+[![CI](https://img.shields.io/github/actions/workflow/status/Anselmoo/copilot-plugin-manager/cicd.yml?branch=main&label=ci)](https://github.com/Anselmoo/copilot-plugin-manager/actions/workflows/cicd.yml)
+[![PyPI publish](https://img.shields.io/badge/publish-PyPI-blue)](https://github.com/Anselmoo/copilot-plugin-manager/actions/workflows/cicd.yml)
+[![PyPI version](https://img.shields.io/pypi/v/copilot-plugin-manager)](https://pypi.org/project/copilot-plugin-manager/)
+[![Python versions](https://img.shields.io/pypi/pyversions/copilot-plugin-manager)](https://pypi.org/project/copilot-plugin-manager/)
+[![License](https://img.shields.io/github/license/Anselmoo/copilot-plugin-manager)](LICENSE)
+
+A Python-first GitHub Copilot plugin manager built with `Typer`, `Rich`, and `Pydantic`.
+
+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 from source
+
+```bash
+git submodule update --init --recursive
+uv sync --group dev
+uv run copilot-plugin-manager --help
+```
+
+The default invocation also works:
+
+```bash
+uv run copilot-plugin-manager
+```
+
+## Quick start
+
+List what is available:
+
+```bash
+uv run copilot-plugin-manager list profiles
+uv run copilot-plugin-manager list themes
+uv run copilot-plugin-manager list sources
+```
+
+Run a one-off command straight from your terminal with `uvx`:
+
+```bash
+uvx copilot-plugin-manager list profiles
+```
+
+`uvx` is convenient for direct execution, but persistent shell completion is easier when the CLI is installed locally or run from a checked-out repository with `uv run`.
+
+Activate a setup for the current repository:
+
+```bash
+uv run copilot-plugin-manager switch python-core
+uv run copilot-plugin-manager switch-exclusive python-mcp
+```
+
+Refresh upstream sources and inspect state:
+
+```bash
+uv run copilot-plugin-manager repo-update --remote
+uv run copilot-plugin-manager status
+```
+
+## Shell completion
+
+Quick shell-init snippets:
+
+```bash
+uv run copilot-plugin-manager shell-init bash
+uv run copilot-plugin-manager shell-init zsh
+uv run copilot-plugin-manager shell-init fish
+uv run copilot-plugin-manager shell-init powershell
+uv run copilot-plugin-manager shell-init nushell
+```
+
+Managed completion files:
+
+```bash
+uv run copilot-plugin-manager completion-install fish
+uv run copilot-plugin-manager completion-install bash
+uv run copilot-plugin-manager completion-script powershell
+```
+
+## Documentation
+
+| Document | Purpose |
+| --- | --- |
+| [`docs/USAGE.md`](docs/USAGE.md) | Managed content, state model, command reference, and shell setup. |
+| [`CONTRIBUTING.md`](CONTRIBUTING.md) | Local development setup, test/lint/build commands, and PR workflow. |
+| [`docs/RELEASING.md`](docs/RELEASING.md) | Build, TestPyPI, and PyPI publishing flow. |
+| [`SECURITY.md`](SECURITY.md) | Vulnerability reporting and supported versions. |
+| [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md) | Community expectations and reporting guidance. |
+| [`LICENSE`](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>

copilot_plugin_manager-0.1.0/pyproject.toml

@@ -0,0 +1,105 @@
+[project]
+name = "copilot-plugin-manager"
+version = "0.1.0"
+description = "Python-first GitHub Copilot plugin, skill, and agent manager"
+readme = "README.md"
+authors = [{ name = "Anselm Hahn", email = "Anselm.Hahn@gmail.com" }]
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.12"
+keywords = [
+    "github-copilot",
+    "copilot",
+    "cli",
+    "plugin-manager",
+    "skills",
+    "agents",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Version Control",
+    "Topic :: Software Development :: Build Tools",
+    "Topic :: Utilities",
+]
+dependencies = ["pydantic>=2,<3", "rich>=14.3.3", "typer>=0.24.1"]
+
+[project.urls]
+Homepage = "https://github.com/Anselmoo/copilot-plugin-manager"
+Repository = "https://github.com/Anselmoo/copilot-plugin-manager"
+Issues = "https://github.com/Anselmoo/copilot-plugin-manager/issues"
+
+[project.scripts]
+copilot-plugin-manager = "copilot_plugin_manager.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.10.9,<0.11.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pre-commit>=4.3.0",
+    "poethepoet>=0.34.0",
+    "pytest>=9.0.2",
+    "pytest-cov>=7.0.0",
+    "ruff>=0.15.0",
+    "twine>=6.2.0",
+    "ty>=0.0.23",
+]
+
+[tool.pytest.ini_options]
+addopts = ["-ra"]
+testpaths = ["test"]
+
+[tool.coverage.run]
+branch = true
+source = ["copilot_plugin_manager"]
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = true
+
+[tool.ruff]
+line-length = 180
+target-version = "py312"
+extend-exclude = ["dist", "external", "legacy"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W"]
+
+[tool.ty.src]
+include = ["src", "test"]
+exclude = ["dist", "external", "legacy"]
+
+[tool.ty.terminal]
+output-format = "full"
+
+[tool.poe.tasks]
+pre-commit = { cmd = "pre-commit run --all-files", help = "Run pre-commit hooks across the repository." }
+test = { cmd = "pytest -q", help = "Run the test suite." }
+test-cov = { cmd = "pytest --cov=copilot_plugin_manager --cov-report=term-missing --cov-report=xml", help = "Run tests with coverage." }
+lint = { cmd = "ruff check .", help = "Run Ruff lint checks." }
+typecheck = { cmd = "ty check", help = "Run ty type checks." }
+refresh-catalog = { cmd = "python scripts/refresh_catalog.py", help = "Regenerate plugin and entrypoint metadata from upstream submodules without legacy bootstrap files." }
+refresh-catalog-reset = { cmd = "python scripts/refresh_catalog.py --hard-reset", help = "Hard-reset entrypoint provenance history and rebuild provider metadata from upstream source files." }
+_build-dist = { cmd = "uv build", help = "Build source and wheel distributions." }
+_check-dist = { shell = "twine check dist/*", help = "Validate built distributions." }
+build = { sequence = [
+    "_build-dist",
+    "_check-dist",
+], help = "Build and validate distributions." }
+check = { sequence = [
+    "lint",
+    "typecheck",
+    "test",
+], help = "Run lint, type checks, and tests." }

copilot_plugin_manager-0.1.0/src/copilot_plugin_manager/__init__.py

@@ -0,0 +1,8 @@
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("copilot-plugin-manager")
+except PackageNotFoundError:
+    __version__ = "0.1.0"
+
+__all__ = ["__version__"]

copilot_plugin_manager-0.1.0/src/copilot_plugin_manager/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+main()