CONTRIBUTING.md

🤝 Contributing to gibr

Thanks for your interest in improving gibr! We welcome all kinds of contributions — from bug fixes and documentation to new feature implementations.

---

🧰 Getting Started

1. Fork the repository
2. Clone your fork:

   git clone https://github.com/<your-username>/gibr.git
   cd gibr

3. Set up your environment

   uv venv
   source .venv/bin/activate
   # or on Windows
   source .venv\Scripts\activate
   uv pip install -e ".[dev,github,gitlab,jira,azure]"

4. Run tests

   pytest

🧪 Code Style & Guidelines

• Use ruff for linting and formatting:

  ruff check .
  ruff format .

• All new features should include unit tests (pytest).
• Keep CLI behavior consistent and user-friendly.
• Follow existing patterns for tracker integration (see github.py, jira.py).