Git Tools

⚠️ This repository contains the original Bun + TypeScript implementation of Git Tools.

The next generation of the project is being rebuilt in Go under Kairos.

Kairos is designed as a modular version control workflow platform where Git becomes a plugin rather than a hard dependency.

The long-term goal is to support multiple VCS backends and workflows.

The rewrite focuses on:

• single-binary distribution
• modular command architecture
• provider-based VCS integrations
• improved performance
• cleaner extensibility

Experimental work may still appear in the V2-beta branch during the migration but not assured, it will be more of a kitchen sink but it's still in .ts.

Contributions are welcome — please keep PRs focused on individual command ports or provider integrations.

With love, Meoli ❤️

Custom Git tools built with TypeScript and compiled to native executables using Bun.

✨ Features

git who

A powerful tool to view Git logs based on author and time range with a clean, easy-to-read interface.

git who [author_name] [--t] [--T]

Features:

• View logs for the current user (default) or a specified author
• Interactive contributor selection with --t flag
• Interactive time range selection with --T flag
• Displays commit details in a formatted table

git labels

A simple tool to fetch and display Git labels from repositories.

git labels <repo-name>

Features:

• List labels from the current repository or a remote repository
• Displays labels in a clean, formatted table
• Fetches labels directly without needing to clone repositories

git pr

An interactive tool for creating GitHub pull requests with ease.

git pr [--preview]

Features:

• Interactive prompts for PR title and body
• Fetches and displays repository collaborators for assignee selection
• Fetches and displays repository labels for multi-selection
• Interactive branch selection for base and head branches
• Preview mode to review the PR command before execution
• Uses the GitHub CLI (gh) for API access and PR creation

Installation

Prerequisites

• Git
• GitHub CLI (optional, recommended)
• Bun (will be installed by the installer if not present)

Quick Install

# Clone the repository
git clone https://github.com/yourusername/git-tools.git
cd git-tools

# Run the installation script
chmod +x install.sh
./install.sh

The installer will:

1. Check and install GitHub CLI (if you choose to)
2. Install Bun if it's not already installed
3. Install required dependencies
4. Build the TypeScript code into native executables
5. Install the executables to the tmp directory in your repository
6. Set up Git aliases with proper help handling

🧰 Usage

git who

# Show logs for current user in the last week
git who

# Show logs for a specific author
git who "Jane Doe"

# Interactive mode to select an author
git who --t

# Interactive mode to select both author and time range
git who --t --T

# Show help
git who --help

git labels

# List labels from the current repository
git labels .

# List labels from a remote repository
git labels https://github.com/user/repo.git

# Show help
git labels --help

git pr

# Create a PR with interactive prompts
git pr

# Create a PR with command preview
git pr --preview

# Show help
git pr --help

📖 Documentation

Man Pages

For full documentation, you can install the man pages:

chmod +x install-man-pages.sh
./install-man-pages.sh

After installing the man pages, you can access them with:

man git-who
man git-labels
man git-pr

🛠️ Development

Setup Development Environment

# Install dependencies
bun install

Development Commands

# Run in development mode
bun run dev:who
bun run dev:labels
bun run dev:pr

# Build tools
bun run build

Project Structure

.
├── install.sh            # Main installation script
├── install-man-pages.sh  # Man pages installation script
├── who.ts                # Source for git-who tool
├── labels.ts             # Source for git-labels tool
├── pr.ts                 # Source for git-pr tool
├── package.json          # Dependencies and scripts
├── tsconfig.json         # TypeScript configuration
├── git-who.1             # Man page for git-who
├── git-labels.1          # Man page for git-labels
├── git-pr.1              # Man page for git-pr
└── tmp/                  # Directory for compiled binaries

🔄 Updating

To update to the latest version:

# Pull the latest changes
git pull

# Run the installation script again
./install.sh

🛡️ Troubleshooting

"No manual entry for git-who"

If you encounter this issue when running git who --help, there are two solutions:

1. Install the man pages (recommended):

   ./install-man-pages.sh

2. Reinstall with the latest script: The latest installation script sets up aliases that handle help flags correctly.

Permission Denied

If you get permission errors when running the tools:

chmod +x tmp/who tmp/labels tmp/pr

---

Git Tag Interactive Tool

Overview

An interactive Git tag creation tool that simplifies the process of creating and managing Git tags.

Features

• Interactive version selection
• Automatic version suggestion
• Descriptive tag messages
• Tag creation confirmation
• Comprehensive tag display

Requirements

• Bun runtime
• Git
• Node.js (for npm packages)

Installation

Quick Install

# Clone the repository
git clone <your-repo-url>
cd <repo-directory>

# Install dependencies
bun install

# Run installation script
chmod +x install.sh
sudo ./install.sh

Manual Installation

# Install dependencies
bun install inquirer chalk ora cli-table3

# Copy script to bin directory
sudo cp tag.ts /usr/local/bin/git-tag
sudo chmod +x /usr/local/bin/git-tag

# Install man page
sudo cp git-tag.1 /usr/share/man/man1/
sudo gzip /usr/share/man/man1/git-tag.1

Uninstallation

# Run uninstall script
sudo ./uninstall.sh

# Or manually remove
sudo rm /usr/local/bin/git-tag
sudo rm /usr/share/man/man1/git-tag.1.gz

Usage

Simply run:

git tag

Follow the interactive prompts to create a new tag.

Uninstall

To uninstall the scripts just edit your .gitconfig file

nvim ~/.gitconfig

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feature: Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

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

🙏 Acknowledgments

• Bun for the amazing runtime and build tools
• Inquirer.js for interactive prompts
• cli-table3 for formatted tables
• ora for elegant terminal spinners