PRBuddy-Go

Automate pull request drafting and code reasoning with your Git history – powered by LLMs and Git hooks.

---

✨ What Is PRBuddy-Go?

PRBuddy-Go is a lightweight CLI assistant that integrates into your Git workflow. It automatically generates pull request drafts after every commit and helps you understand your changes with natural language summaries.

Whether you're working solo or in a team, PRBuddy helps you keep your code explainable and your PRs professional — effortlessly.

---

🛠 Features

• LLM-powered PR Drafts: Hooks into post-commit to auto-generate contextual pull request messages.
• Quick Assist Chat: Get fast, contextual help from an LLM in your terminal.
• "What did I just do?" summaries with prbuddy-go what
• Optional Git hook installation during init
• Cleanup with prbuddy-go remove

---

📦 Installation

Prerequisites

Before using PRBuddy-Go, make sure the following are installed on your system:

• Go 1.20 or later
• Git (with a local repository)
• Ollama – a local LLM runtime for running models like llama3 or codellama.

PRBuddy-Go uses Ollama to run large language models locally for generating PR drafts and summaries.

Install Ollama

Follow the official instructions at https://ollama.ai/download

Install

Clone and build manually:

git clone https://github.com/soyuz43/PRbuddy.git
cd PRbuddy
go build -o prbuddy-go

---

⚡ Quick Start

cd your-project/
prbuddy-go init        # Installs Git hook + .git/pr_buddy_db
git add .
git commit -m "feat: add logging"  # Triggers PR draft generation

---

⚙️ Model Selection

PRBuddy-Go will use:

1. The model set via the extension (/extension/model)
2. PRBUDDY_LLM_MODEL environment variable
3. The most recently pulled model (auto-detected)
4. If no models are found, PRBuddy will automatically run qwen3 locally via Ollama.

---

🧪 Commands

Command	Description
init	Setup PRBuddy in current repo; installs optional Git hook
post-commit	Used internally by the hook to draft PR messages
what	Summarize local changes since last commit
quickassist [query]	Ask the LLM anything, or run interactive CLI chat
remove	Uninstall PRBuddy from the repo

---

How It Works

• Uses Git hooks to run logic after commits
• Detects branch, commit, diff context
• Sends data to an LLM backend (e.g., OpenAI, local model?)
• Generates structured PR drafts
• Stores metadata in .git/pr_buddy_db for traceability

✅ You can disable or uninstall anytime using: prbuddy-go remove

---

🔐 Privacy & Security

PRBuddy reads your local Git data and may transmit code context to an LLM service. Make sure you're comfortable with the models you're using and consider privacy policies if sensitive code is involved.

---

🤝 Contributing

This project is in early development. Bug reports, ideas, and PRs are welcome!

---

📄 License

MIT © soyuz43