Thira - Git Hooks Manager

Thira is a Git hooks manager and commit message linter that helps you maintain consistent commit messages and automate your Git workflows.

Features

• Easy Git hooks management: Install, update, and remove Git hooks with a single command. Supports all standard Git hook events and custom hooks directories.
• Conventional commit message validation: Enforces customizable commit message rules based on the Conventional Commits standard, including type, scope, and subject/body length.
• Custom script automation: Define and run custom scripts for any workflow, with support for sequential or parallel execution, environment variables, and working directories.
• Flexible YAML configuration: Manage hooks, scripts, and linting rules in a single, human-readable hooks.yaml file.
• Cross-platform support: Works seamlessly on macOS, Linux, and Windows.
• Colorful and informative CLI: User-friendly command-line interface with colored output, helpful error messages, and command trees.
• Auto-installation and validation: Automatically installs hooks and validates configuration integrity for a smooth developer experience.
• Real-time terminal UI: Displays live output and progress for long-running scripts and hook executions.
• Integrates with Cargo, npm, and pip: Installable via multiple package managers for easy adoption in any workflow.

Documentation

Our documentation is split into several sections for easier navigation:

• Installation Guide - How to install and set up Thira
• Basic Usage - Getting started with Thira
• Configuration Guide - Complete reference for hooks.yaml configuration
• Hook Management - Managing Git hooks
• Script Management - Creating and managing custom scripts
• Commit Message Guidelines - How to write valid commit messages

Quick Start

# Install with installer
curl -sSL https://raw.githubusercontent.com/ervan0707/thira/main/install.sh | bash

# Install with Cargo
cargo install thira

# Install with NPM
npm install -g thira

# Install with pip
pip install thira

# Install with Nix (flakes)
nix profile install github:ervan0707/thira

# Or run directly without installing
nix run github:ervan0707/thira

# Initialize configuration
thira hooks init

# Install Git hooks
thira hooks install

Your Git hooks are now managed by Thira! Check out the Basic Usage guide for more details.

Project Status

This project is under active development. Feel free to open issues and submit pull requests.

License

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