Copilot Brag Sheet
Turn vague "what did I do?" into evidence-backed impact statements — automatically, every Copilot CLI session.
🔒 Local-first · 🤝 MCP-conformant · 🚫 Zero telemetry
A GitHub Copilot CLI extension that silently records your work as you go — files edited, PRs created, git actions — so when performance review season hits, you have receipts instead of a blank page. (What's a brag sheet?)
👋 Microsoft engineer? Jump to Connect-optimized framing →
🌐 Landing page: microsoft.github.io/copilot-brag-sheet · 🖼️ Social preview
Requires: Node.js 18+, GitHub Copilot CLI (with active Copilot subscription)
Why an extension, not just a SKILL.md?
If you've seen the brag-sheet skill listed elsewhere — that's our SKILL.md, the LLM guidance file. It's a prompt that tells the agent how to think about your work. This repo ships the prompt plus the extension that makes it actually happen:
| Just the SKILL.md | The full extension (this) |
|---|
| LLM has to remember the trigger | Auto-captures every session |
| LLM runs shell commands by hand | Direct file/PR/git tracking via Node API |
| LLM formats markdown each time | Deterministic, typed, crash-safe |
| Markdown stored "somewhere" | Structured local JSON, atomic writes, orphan recovery |
| Re-curl to update | npm update or one-line re-install |
Want just the prompt? Use the skill — also published in github/awesome-copilot.
Want it to actually happen automatically? Install the extension below.
What It Does
Every time you use GitHub Copilot CLI, this extension automatically:
- 📊 Tracks your session — repo, branch, files edited/created, PRs, git actions
- 📝 Captures context — first prompt as task description, session duration
- 🔒 Stores locally — structured JSON records in your OS app-data directory
- 🚀 Crash-safe — atomic writes, orphan recovery, emergency shutdown saves
Plus three tools the agent can call on your behalf:
| Tool | What it does |
|---|
save_to_brag_sheet | Save a work accomplishment to your impact log |
review_brag_sheet | Review recent entries for performance discussions |
generate_work_log | Render all records into a Markdown file |
Runtime compatibility
| Runtime | Manual tools | Auto-tracking | Status |
|---|
| Copilot CLI | ✅ Full | ✅ Full | Production |
| MCP hosts (Claude, Cursor, VS Code) | ✅ Full | ⚠️ Phase 2 | Beta |
| Agency | ✅ Full | ⚠️ Phase 2 | Beta |
MCP / Agency users: The three tools (save_to_brag_sheet, review_brag_sheet, generate_work_log) work fully. Automatic session tracking (files edited, PRs created, git actions) requires the Copilot CLI joinSession() runtime and is not yet available in other hosts. For now, say "brag — <accomplishment>" to capture work manually.
Copilot CLI users: Full automatic tracking works today — no action needed.
When the agent will use this
The agent picks up these tools when you say (anything close to) one of:
brag · log work · save accomplishment · what did I ship · review my work · summarize my impact · generate work log · prep my brag sheet · promo packet · perf review · Connect prep · self-review · weekly recap · monthly summary · what did I do this quarter
You don't need to memorize the list — just talk naturally about your work and the agent will figure it out.
Install (60 seconds)
⚠️ Don't use copilot plugin install. This is a joinSession() extension and must live in ~/.copilot/extensions/. Tracking github/copilot-cli#3023. Use one of the methods below.
Recommended: one-liner
