Skip to content

Repository files navigation

Cá Bhfuil

Irish for "where is" - Git repository analysis tool for open source maintainers

Cá Bhfuil (pronounced "caw will") helps open source maintainers track patches, fixes, and features across their stable branches.

CI pre-commit.ci

The Problem

  • "Did CVE-2024-1234 get backported to all supported stable branches?"
  • "Where is the fix for this memory leak across our release branches?"
  • "What fixes are in main but missing from stable/v2.1?"

The Solution

ca-bhfuil "CVE-2024-1234"           # Find security fixes across branches
ca-bhfuil abc123def --distribution  # See where this commit landed
ca-bhfuil --missing-from stable/v2.1 # What needs backporting

Key Features

  • 🚀 Performance First: 10x+ faster than GitPython using pygit2
  • 🔒 Local-First: SQLite storage, no external databases
  • 🧠 AI-Enhanced: Local LLM integration with privacy controls
  • 🎯 Maintainer-Focused: Built for real stable branch workflows

Quick Start

# Install from PyPI (when available)
pip install ca-bhfuil

# Or run with container
docker run --rm -v $(pwd):/workspace ghcr.io/seanmooney/ca-bhfuil:latest --help

Documentation

For Users

For Contributors

For AI Assistants

Project Status

Current Phase: Core development (CLI, configuration, git operations)
License: MIT
Development Model: Human + AI collaborative development


"Because tracking changes across stable branches shouldn't require a computer science degree."

Built by a maintainer, for maintainers who just want to know where their fixes landed.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages