⚠️ This repository has moved! The canonical home is now microsoft/copilot-brag-sheet. Please update your bookmarks, star the new repo, and file any issues there.

Never lose track of what you shipped — auto-log every AI coding session.

A brag sheet is a running record of your accomplishments — so when review season arrives, you have receipts, not a blank page. This extension builds yours automatically.

Most developers can't remember what they shipped last week, let alone last quarter. This Copilot CLI extension silently records your work as you go — files edited, PRs created, git actions — so when it's time for a performance review, you have a complete, impact-framed log.

Zero dependencies. Local-first. Cross-platform.

Requires: Node.js 18+, GitHub Copilot CLI (with active Copilot subscription)

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:

One-liner:

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

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

Or clone and install (includes interactive setup wizard):

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

The setup wizard will ask a few optional questions (Microsoft preset, git history, remote sync). You can re-run it anytime:

node ~/.copilot/extensions/copilot-brag-sheet/bin/setup.mjs

After installing, run /clear in the Copilot CLI or restart it to load the extension.

Start a Copilot CLI session — the extension loads automatically:

📊 Work logger active

That's it. Sessions are tracked in the background. When you want to log notable work:

You: "brag — shipped the auth refactor"
Agent: [calls save_to_brag_sheet with summary, category, impact]

Or review your recent work:

You: "show me my recent work"
Agent: [calls review_brag_sheet]

You: "generate my work log"
Agent: [calls generate_work_log → writes work-log.md]

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

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "session",
  "timestamp": "2025-04-14T14:30:00.000Z",
  "endTime": "2025-04-14T15:45:00.000Z",
  "repo": "copilot-brag-sheet",
  "branch": "main",
  "cwd": "/home/user/repos/copilot-brag-sheet",
  "filesEdited": ["lib/config.mjs", "test/config.test.mjs"],
  "filesCreated": ["docs/backfill-guide.md"],
  "prsCreated": [],
  "significantActions": ["git commit", "git push"],
  "taskDescription": "Add Microsoft preset support to config",
  "status": "finalized"
}

You don't write these — they're captured automatically in the background.

When you (or the AI) calls save_to_brag_sheet:

You: "brag — shipped the auth service refactor"
Agent: I'll save that to your brag sheet.

  Summary: Refactored auth service to use managed identity → eliminated 3 secret 
           rotation incidents per quarter → reduced on-call burden for the team
  Category: infrastructure
  Impact: Eliminated recurring secret rotation incidents, improved team velocity
  
  ✅ Entry saved to brag sheet [infrastructure]: "Refactored auth service..."

Running generate_work_log produces a Markdown file like this:

# Work Impact Log

## Week of 2025-04-14

### 🚀 PRs & Features
- **[copilot-brag-sheet] Built and published v2 with modular architecture** — 107 tests, cross-platform CI

### 🏗️ Infrastructure
- **[auth-service] Refactored auth to managed identity** — Eliminated 3 secret rotation incidents/quarter

With { "preset": "microsoft" } in your config, the AI automatically frames entries for Connect:

You: "brag — I shipped the Grafana dashboard migration"

Agent: Summary: Led Grafana dashboard migration to Azure Managed Grafana → 
               consolidated 15 dashboards across 3 teams → reduced 
               monitoring infrastructure costs by 40%

Session Start ──► Track files, PRs, git actions ──► Session End
     │                      │                            │
     ▼                      ▼                            ▼
  Create JSON          Update JSON                 Finalize JSON
  (status: active)     (incremental)               (status: finalized)

<data-dir>/
├── sessions/2025/04/2025-04-14T20-00-00.000Z_<uuid>.json
├── entries/2025/04/2025-04-14T20-05-00.000Z_<uuid>.json
├── config.json    (optional)
└── errors.log

Default data directory:

{
  "preset": "microsoft",
  "categories": [
    { "id": "deployment", "emoji": "🚢", "label": "Deployments" }
  ],
  "output": {
    "includeSessionLog": true
  },
  "git": {
    "enabled": true,
    "push": false
  }
}

{ "preset": "microsoft" }

Or just answer "y" during installation. See the full docs at microsoft/copilot-brag-sheet.

• Node.js 18+
• GitHub Copilot CLI
• Zero runtime dependencies

git clone https://github.com/microsoft/copilot-brag-sheet.git
cd copilot-brag-sheet
npm test        # 84 tests, ~1s

See CONTRIBUTING.md for development guidelines.

MIT © Vidhart Bhatia