Report Issues GitHub
🤖
AI-Assisted Conflict Resolution
Claude analyzes merge conflicts and suggests intelligent resolutions based on code context and intent.
📊
Rebase Planning
Get AI recommendations on the best rebase strategy before you start.
🔍
Conflict Explanation
Understand why conflicts occurred and how to resolve them with clear explanations.
🛡️
Safe Operations
Preview changes before applying, with easy abort options and --dry-run support.
💻
Cross-Platform
Works seamlessly on macOS and Linux with consistent behavior across platforms.
🔧
Configurable
Customize behavior via config file or environment variables to fit your workflow.

📦 Installation

From GitHub

# Install directly from GitHub
pip install git+https://github.com/GitNudge/gitnudge.git

# Install a specific version
pip install git+https://github.com/GitNudge/gitnudge.git@v0.1.0

From Source

git clone https://github.com/GitNudge/gitnudge.git
cd gitnudge
pip install -e .

🚀 Quick Start

1. Set your API key

export ANTHROPIC_API_KEY="your-api-key"

# Or use the config command
gitnudge config --set-key

2. Start rebasing with AI

# Analyze potential conflicts first
gitnudge analyze main

# Rebase with AI assistance
gitnudge rebase main

# Get AI help when conflicts occur
gitnudge resolve

📖 Commands

gitnudge rebase <target> Start an AI-assisted rebase onto target branch
gitnudge analyze <target> Analyze potential conflicts before rebasing
gitnudge resolve [file] Get AI help resolving conflicts
gitnudge continue Continue rebase after resolving conflicts
gitnudge abort Abort the current rebase operation
gitnudge config --show Show or modify configuration

Common Options

gitnudge rebase main --dry-run     # Preview without changes
gitnudge rebase -i HEAD~5          # Interactive rebase
gitnudge resolve --auto            # Auto-apply AI suggestions
gitnudge analyze --detailed main   # Detailed AI analysis

⚙️ Configuration

GitNudge can be configured via environment variables or config file at ~/.config/gitnudge/config.toml

Environment Variables

Variable Description
ANTHROPIC_API_KEY Your Anthropic API key (required)
GITNUDGE_MODEL Claude model to use (default: claude-sonnet-4-20250514)
GITNUDGE_CONFIG Path to config file
GITNUDGE_NO_COLOR Disable colored output

Config File Example

# ~/.config/gitnudge/config.toml

[api]
model = "claude-sonnet-4-20250514"

[behavior]
auto_stage = true
show_previews = true
max_context_lines = 500

[ui]
color = true
verbosity = "normal"

Questions? Reach out at info@gitnudge.ai