💁 Brag AI

Generate and maintain a brag document automatically from your GitHub contributions, powered by AI.

Because your awesome work deserves to be remembered! ✨

Overview

Ever had that moment when your manager asks "So, what have you been up to?" and your mind goes blank?

Brag AI is your personal achievement historian! It helps you create and maintain a "brag document" - a fancy record of all the cool stuff you've done. It dives into your GitHub activity and transforms those cryptic commit messages into beautiful, human-readable achievements that will make your portfolio shine! ✨

Perfect for:

• 📊 Performance reviews (without the last-minute panic)
• 💼 Job applications (show off with style)
• 📈 Personal development tracking (watch yourself grow!)
• 🎉 Impressing your friends (and maybe your pet - results may vary)

Features

• 🔍 GitHub Integration: Automagically analyzes your commits to generate achievement descriptions
• 🏠 Local Repository Support: Generate brag documents from local Git repositories
• 🤖 AI-Powered: Turns "fix: bug in login" into "Enhanced system reliability by resolving critical authentication issues"
• 📝 Incremental Updates: Update existing brag documents with new contributions over time
• 💻 CLI Tool: Easy to use command-line interface

Quick Start

Install brag-ai using uv, pipx or pip:

# Install the package
uv tool install brag-ai
# or
# pipx install brag-ai
# or
# pip install brag-ai

# Generate a brag document from a GitHub repository
brag from-repo \
  --repo owner/repo \
  --user github-username

# Update an existing brag document with new contributions saving the output to a new file
brag from-repo \
  --repo owner/repo \
  --user github-username \
  --input existing-brag.md \
  --output updated-brag.md

If you use uv, you can also install and run this tool in one go using the uvx tool:

uvx --from brag-ai brag from-repo owner/repo --user github-username

The final step is then: ⭐ star this repo!

Documentation

For detailed instructions, please refer to the documentation:

• Installation Guide
• Usage Guide
• Configuration Options
• Development Guide

Coming Soon™ 🚀

• 🌐 Web Interface: Because sometimes clicking is better than typing
• 🤝 Extended GitHub Integration: Support for PR reviews, issues, and discussions
• 🔄 Integration with other tools: GitLab, Bitbucket, and more
• 📝 Custom Templates: Make your brag document as unique as you are
• 📦 Export Options: More ways to show off your achievements (JSON brag documents anyone?)
• 🔒 Local Processing: Your precious data stays on your machine if you use local LLMs

Contributing

Got ideas? We'd love to hear them! Check out our Contributing Guide to join the fun! 🎈

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

• 📖 Documentation
• 🐛 Issue Tracker
• 💬 Discussions
• 💻 Repository

Why Brag AI?

Maintaining a brag document is crucial for career development, but it's often overlooked or forgotten until it's time for a performance review. Brag AI automates this process, helping you capture your achievements while they're fresh or after a long time.

Built with ❤️ and ☕ by Ruan Comelli

Remember: It's not bragging if it's true! ✨