microsoft/copilot-brag-sheet

microsoft/copilot-brag-sheet

Description: Auto-track every Copilot CLI coding session into a structured work impact log. Zero deps, local-first, cross-platform.

Language: JavaScript

License: MIT

Stars: 8

Forks: 1

Open issues: 14

Created: 2026-04-16T21:48:09Z

Pushed: 2026-06-20T03:41:46Z

Default branch: main

Fork: no

Archived: no

README:

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 →](#microsoft-employees-connect--performance-reviews)

🌐 Landing page: microsoft.github.io/copilot-brag-sheet · 🖼️ [Social preview](docs/og-image.png)

> 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](skills/brag-sheet/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 — " 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

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/microsoft/copilot-brag-sheet/main/install.sh | bash

# Windows (PowerShell 5.1+)
irm https://raw.githubusercontent.com/microsoft/copilot-brag-sheet/main/install.ps1 | iex

The interactive setup wizard runs automatically when your terminal supports it.

Alternative: from npm

npm install -g copilot-brag-sheet
copilot-brag-sheet # copies files + runs setup wizard

For contributors

git clone https://github.com/microsoft/copilot-brag-sheet.git
cd copilot-brag-sheet
./install.sh # macOS/Linux
.\install.ps1 # Windows

Activate

After install, run /clear (or restart Copilot CLI). On your first message you'll see:

📊 Work logger active

Re-run setup anytime with copilot-brag-sheet-setup (after npm install) or node ~/.copilot/extensions/copilot-brag-sheet/bin/setup.mjs.

> Install failing? Open an issue with the error — Windows + macOS + Linux are CI-tested.

Use

Two things you do, ever

1. Say "brag" when you ship something.

You: brag — refactored auth to managed identity, killed 3 secret-rotation incidents/qtr
Agent: [calls save_to_brag_sheet with summary, category, and impact]

2. Run "generate my work log" before review season.

You: generate my work log
Agent: [calls generate_work_log → writes a categorized markdown file you can paste into your perf doc]

Everything else (file tracking, PR detection, git actions) is automatic. Most users only do step 2 once per quarter.

Optional: review recent work

You: show me my last 2 weeks
Agent: [calls review_brag_sheet]

Examples

What a session record looks like (auto-captured JSON)

Every Copilot CLI session automatically produces a JSON record like this:...