← projects

a structured place to record your wins

Bragfile is a simple tool for capturing accomplishments as they happen, so that performance reviews, resumes, and weekly updates write themselves.

install

brew install bragfile

capture a win

brag add -t "shipped the auth refactor" \
         -T "auth,security" -p platform \
         -i "cut login p99 from 1.2s → 340ms"

no flags? brag add opens $EDITOR with a template.

see what you've captured

brag list --since 30d

• ◆ shipped the auth refactor 2026-05-28
  platform #auth#security

  cut login p99 from 1.2s → 340ms

• ◆ cut p99 latency on /search 2026-05-22
  search #perf

  38% reduction; unblocked mobile v3 release

• ◇ mentored two engineers through their first on-call rotation 2026-05-18
  team #oncall#mentorship

  both completed without paging me; positive retro feedback

• ◆ wrote DEC-014: spec-first review gates 2026-05-12
  process #process#spec-driven

  adopted by 3 teams in the first week

• ○ learned PKL well enough to write the deploy manifests 2026-05-04
  infra #pkl#iac

  replaced 600 lines of YAML with 180 of PKL

generate your self-review

brag export --format markdown --since "Q2 2026" > review.md

groups entries by project, surfaces impact statements, ready to paste into a doc.