Overview

Gitbruv is an AI-powered command-line interface that lets you interact with Git using natural language. Instead of memorizing complex flags and workflows, you describe what you want to do, and Gitbruv translates it into safe, executable Git commands.

It is built for developers who want speed, safety, and clarity without sacrificing control.

Features

Natural Language Commands

Describe your intent in plain English. Gitbruv interprets your request, generates the appropriate Git command, and executes it safely.

Safety-First Execution

Built-in guardrails block destructive operations such as hard resets, force pushes, and shell injection attempts.

Smart Conflict Resolution

Resolve merge conflicts using human-readable strategy flags instead of manually editing markers across multiple files.

One-Command Deploys

Stage, commit, and push in a single streamlined command.

Improved Terminal Experience

Readable, structured, and color-enhanced output designed to make Git status and actions easier to understand.

Context-Aware Suggestions

Gitbruv understands your repository state and recommends logical next steps.

Installation

Install Gitbruv globally via npm:

npm install -g gitbruv

Requires Node.js installed on your system.

Usage

Natural Language Execution

Wrap your intent in quotes and Gitbruv will handle the rest.

# Stage and commit changes
gitbruv "commit my changes"

# Push current branch to remote
gitbruv "push to main branch"

# Undo last commit but keep file changes
gitbruv "undo my last commit but keep the files"

Status

View repository status in a clearer, more structured format.

gitbruv status

Deploy

Stage, commit, and push in one command.

gitbruv deploy -m "Fix authentication bug" --all

Options:

• -m Set commit message
• --all Stage all modified and untracked files

Merge

Merge branches with optional conflict strategy handling.

gitbruv merge feature/auth --strategy incoming

Options:

• --strategy incoming Prioritize changes from the incoming branch
• --strategy current Keep current branch changes

Resolve Conflicts

Apply bulk resolution strategies during a merge conflict state.

gitbruv resolve --strategy incoming

gitbruv resolve --strategy current

Safety Model

Gitbruv protects your repository by intercepting risky operations before execution.

Blocked operations include:

• Hard resets (reset --hard)
• Force pushes (--force, -f)
• Potential shell injection attempts (&&, chained destructive commands)

When a dangerous action is detected, Gitbruv explains the risk and halts execution.

Philosophy

Gitbruv reduces cognitive overhead. It lets developers focus on building instead of remembering Git syntax. You describe the outcome. Gitbruv handles the mechanics.

Contributing

Contributions are welcome. Please open an issue or submit a pull request with a clear explanation of your changes.

License

This project is licensed under the MIT License.