Aaron Powell
a7fdcd5006
* feat: migrate plugins and extensions to Agent Plugins v1.0.0 spec - Add \ to all 69 curated plugin manifests - Migrate all 18 extension manifests: add \, move logo into xtensions.com.github.copilot.logo namespace, remove top-level logo and string xtensions: '.' - Update eng/validate-plugins.mjs: require \, validate namespace-keyed extensions object for canvas extensions, widen name pattern to allow dots (spec §5.5, max 64 chars) - Update eng/materialize-plugins.mjs: emit spec-clean served manifests (only spec fields: \, name, version, description, author, homepage, repository, license, keywords, extensions) - Update eng/generate-website-data.mjs: read logo from namespace with fallback to top-level logo for compatibility - Update eng/create-plugin.mjs: scaffold emits \ - Add .github/workflows/validate-plugins.yml: blocking CI for PRs touching plugins/** or extensions/** - Add spec compliance check to external plugin quality gates: non-blocking warnings with ✅/⚠️/🛑 emoji legend - Update AGENTS.md: document new extension manifest shape, add \ to plugin checklist Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 8f3a88cb-e01e-4760-8125-460490dc1a76 * refactor: consolidate canvas extension plugins - Move all extension plugin manifests from extensions/<name> to plugins/<name> - Keep extensions/<name> as reusable source only - Remove standalone extension discovery from marketplace and website plugin catalogs - Auto-bundle same-name extension sources during materialization - Add build-only extensions.json references for sharing extensions across plugins - Remove x-awesome-copilot extension metadata support - Update validation and contributor documentation Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 8f3a88cb-e01e-4760-8125-460490dc1a76 * feat: add canvas extension scaffolding skill - Add repo-local skill for creating canvas extension sources - Generate spec-compliant plugin manifests under plugins/ - Support registering reusable extensions with multiple plugins - Remove guidance for extension-local plugin manifests and custom fields Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 8f3a88cb-e01e-4760-8125-460490dc1a76 * fix: align extension namespaces with current guidance - Use each extension ID as its manifest namespace key - Update validation and website generation to resolve extension-specific namespaces - Upsert plugin validation PR comments using the existing repository pattern Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 8f3a88cb-e01e-4760-8125-460490dc1a76 * fix: use Copilot extension namespace - Adopt com.github.copilot for all canvas extension manifests - Require the namespace during validation and website generation - Update extension scaffolding guidance Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 8f3a88cb-e01e-4760-8125-460490dc1a76 * docs: regenerate plugin catalog after merge Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 8f3a88cb-e01e-4760-8125-460490dc1a76 * refactor(plugins): move manifests to plugin roots Use root plugin.json manifests and namespaced extension directories throughout local tooling, validation, generation, and contributor documentation. Restore materialize-plugins.mjs line breaks so the source remains readable in GitHub. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 8f3a88cb-e01e-4760-8125-460490dc1a76 * feat(plugins): migrate manifests to namespaced composition Move repository composition metadata under com.github.awesome-copilot, materialize reusable extensions into the plugin extensions directory, and improve contributor and PR validation guidance. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 8f3a88cb-e01e-4760-8125-460490dc1a76 * fix(validation): address plugin review findings Restore executable build scripts, validate namespaced manifests and hook directories, improve README item counts, and manage validation comments across reruns. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 8f3a88cb-e01e-4760-8125-460490dc1a76 * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Copilot-Session: 8f3a88cb-e01e-4760-8125-460490dc1a76
Napkin — Visual Whiteboard for Copilot CLI
A whiteboard that opens in your browser and connects to Copilot CLI. Draw, sketch, add sticky notes — then share everything back with Copilot. Copilot sees your drawings and responds with analysis, suggestions, and ideas.
Built for people who aren't software developers: lawyers, PMs, business stakeholders, designers, writers — anyone who thinks better visually.
Installation
Install the plugin directly from Copilot CLI:
copilot plugin install napkin@awesome-copilot
That's it. No other software, accounts, or setup required.
Verify It's Installed
Run this in Copilot CLI to confirm the plugin is available:
/skills
You should see napkin in the list of available skills.
How to Use It
Step 1: Say "let's napkin"
Open Copilot CLI and type let's napkin (or "open a napkin" or "start a whiteboard"). Copilot creates a whiteboard and opens it in your browser.
Step 2: Your whiteboard opens
A clean whiteboard appears in your browser with simple drawing tools. If it's your first time, a quick welcome message explains how everything works.
Step 3: Draw and brainstorm
Use the tools to sketch ideas, add sticky notes, draw arrows between concepts — whatever helps you think. This is your space.
Step 4: Share with Copilot
When you're ready for Copilot's input, click the green Share with Copilot button. It saves a screenshot and copies your notes.
Step 5: Copilot responds
Go back to your terminal and say check the napkin. Copilot looks at your whiteboard — including your drawings — and responds.
What's Included
Skill
| Skill | Description |
|---|---|
napkin |
Visual whiteboard collaboration — creates a whiteboard, interprets your drawings and notes, and responds conversationally |
Bundled Assets
| Asset | Description |
|---|---|
assets/napkin.html |
The whiteboard application — a single HTML file that opens in any browser, no installation needed |
Whiteboard Features
| Feature | What it does |
|---|---|
| Freehand drawing | Draw with a pen tool, just like on paper |
| Shapes | Rectangles, circles, lines, and arrows — wobbly shapes snap to clean versions |
| Sticky notes | Draggable, resizable, color-coded notes (yellow, pink, blue, green) |
| Text labels | Click anywhere to type text directly on the canvas |
| Pan and zoom | Hold spacebar and drag to move around; scroll to zoom |
| Undo/Redo | Made a mistake? Ctrl+Z to undo, Ctrl+Shift+Z to redo |
| Auto-save | Your work saves automatically — close the tab, come back later, it's still there |
| Share with Copilot | One button exports a screenshot and copies your text content |
How Copilot Understands Your Drawings
When you click "Share with Copilot," two things happen:
-
A screenshot is saved (
napkin-snapshot.pngin your Downloads or Desktop folder). Copilot reads this image and can see everything — sketches, arrows, groupings, annotations, sticky notes, spatial layout. -
Your text is copied to clipboard. This gives Copilot the exact text from your sticky notes and labels, so nothing gets misread from the image.
Copilot uses both to understand what you're thinking and respond as a collaborator — not a computer analyzing data, but a colleague looking at your whiteboard sketch.
What Can You Draw?
Anything. But here are some things Copilot is especially good at interpreting:
| What you draw | What Copilot understands |
|---|---|
| Boxes connected by arrows | A process flow or workflow |
| Items circled together | A group of related ideas |
| Sticky notes in different colors | Categories or priorities |
| Text with a line through it | Something rejected or deprioritized |
| Stars or exclamation marks | High-priority items |
| Items on opposite sides | A comparison or contrast |
| A rough org chart | Reporting structure or team layout |
Keyboard Shortcuts
You don't need these — everything works with mouse clicks. But if you want to work faster:
| Key | Tool |
|---|---|
| V | Select / move |
| P | Pen (draw) |
| R | Rectangle |
| C | Circle |
| A | Arrow |
| L | Line |
| T | Text |
| N | New sticky note |
| E | Eraser |
| Delete | Delete selected item (not yet supported) |
| Ctrl+Z | Undo |
| Ctrl+Shift+Z | Redo |
| Space + drag | Pan the canvas |
| ? | Show help |
FAQ
Do I need to install anything besides the plugin? No. The whiteboard is a single HTML file that opens in your browser. No apps, no accounts, no setup.
Does it work offline? Yes. Everything runs locally in your browser. No internet connection needed for the whiteboard itself.
What browsers work? Any modern browser — Chrome, Safari, Edge, Firefox. Chrome works best for the "copy to clipboard" feature.
Can I save my work? Yes, automatically. The whiteboard saves to your browser's local storage every few seconds. Close the tab, come back later, your work is still there.
Can Copilot really understand my drawings? Yes. The AI models powering Copilot CLI (Claude, GPT) can interpret images. They can see your sketches, read your handwriting-style text, understand spatial relationships, and interpret common visual patterns like flowcharts, groupings, and annotations.
What if I'm not a good artist? Doesn't matter. The whiteboard snaps wobbly shapes to clean versions, and Copilot is trained to interpret rough sketches. Stick figures and messy arrows work just fine.
How do I start over? Say "let's napkin" again in the CLI. Copilot will ask if you want to keep the existing whiteboard or start fresh.
What platforms are supported?
macOS, Linux, and Windows. The whiteboard runs in any browser. Clipboard integration uses platform-native tools (pbpaste on macOS, xclip on Linux, PowerShell on Windows).
Source
This plugin is part of Awesome Copilot, a community-driven collection of GitHub Copilot extensions.
License
MIT