DiffDog 🐕

DiffDog (invoked as bark) is a CLI tool that sniffs through your daily git commits across multiple repositories and uses LLM (Groq) to bark out a clean, formatted daily update summary. It automatically copies the result to your clipboard.

🛠 Installation

Using uv (Recommended)

uv tool install diffdog

Using pip

pip install diffdog

⚙️ Setup

You need a config.yaml file to get started.

1. Get an API Key: Create a free key at https://console.groq.com/keys
2. Create your config: Create a config.yaml with the following structure:

author: "Your Name"
groq_key: "gsk_xxxx..."
model: "llama-3.3-70b-versatile" # Optional
no_copy: false # Optional
repos:
  - "~/projects/work-app"
  - "~/projects/side-hustle"
titles:
  - "Work App"
  - "Side Project"
notes: # Optional
  - "The updates must sound like a rap"

Note: The author field must have either the name or email you commit with, it's used to get your commits from your repos. Note: The number of repos must match the number of titles.

3. Initialize the tool:

bark -c path/to/your/config.yaml

🚀 Usage

Generate and copy summary to clipboard:

bark

Print summary without copying to clipboard:

bark --no-copy

Pass notes to the bot to customize the summary:

bark --note "The updates must sound like a rap"

Register a repo (not specifying a path registers the current directory):

bark --repo ~/path/to/repo --title "A project of mine"

Register a repo with a perferred branch (defaults to main):

bark --repo ~/path/to/repo --title "A project of mine" --branch some-branch

Unregister a repo (not specifying a path unregisters the current directory):

bark --rm-repo ~/path/to/repo

View current configuration:

bark --show-conf

🔄 Updating Configuration

If you need to change your settings:

1. Run bark --show-conf > config.yaml to save your current settings to a file.
2. Edit the config.yaml file with your changes.
3. Re-assign it by running bark -c config.yaml.