GitHub Copilot CLI plugins

GitHub Copilot CLI plugins, including ports of Cursor plugins and first-party plugins authored in this repo. Each plugin is a standalone directory with its own plugin.json manifest.

Working on this repo with an AI agent? Start with AGENTS.md. Contributing? See CONTRIBUTING.md. Authoring a new plugin? See docs/authoring-plugins.md.

Plugins

Plugin	Type	Description	Install
Thermos	Ported	Thermo-nuclear branch review: deep security/correctness audits, harsh code-quality rubrics, and combined review orchestration.	copilot plugin install github:tomazb/copilot-plugins/thermos
Example Agent	First-party	Minimal template plugin (one agent + one skill) to copy when authoring new plugins.	copilot plugin install ./plugins/example-agent

Repository structure

copilot-plugins/
├── AGENTS.md                # Guidance for agents working on this repo
├── CONTRIBUTING.md          # Contributor workflow
├── docs/authoring-plugins.md
├── package.json             # npm script entrypoints (zero runtime deps)
├── thermos/                 # Generated Copilot CLI plugin (do not edit by hand)
├── vendor/thermos/          # Vendored Cursor source from cursor/plugins
├── plugins/                 # First-party plugins authored here
│   └── example-agent/
├── UPSTREAM_SHA             # Pinned cursor/plugins commit for vendor/thermos
├── scripts/
│   ├── sync-copilot-plugin.mjs
│   ├── validate-copilot-plugin.mjs
│   └── validate-all.mjs
└── .github/workflows/

Development

Node >=20 is required. There are no runtime dependencies, so no npm install is needed.

npm test             # run unit tests
npm run sync         # regenerate thermos/ from vendor/thermos/
npm run sync:check   # verify thermos/ is in sync
npm run validate:all # validate every plugin
npm run check        # all of the above (matches CI)

Install a plugin locally:

copilot plugin install ./thermos
copilot plugin install ./plugins/example-agent

Do not edit generated files under thermos/ by hand. Update vendor/thermos/ from cursor/plugins and run npm run sync. First-party plugins under plugins/* are edited directly.

Upstream sync

A weekly GitHub Action compares vendor/thermos/ to cursor/plugins main and opens a PR when upstream changes. See .github/workflows/sync-upstream.yml.

License

MIT (see per-plugin LICENSE files).