Git Integration

PraisonAI CLI provides deep Git integration for tracking changes, auto-committing with AI-generated messages, and managing your version control workflow seamlessly.

Overview

Git integration features:

Auto-commit - Commit with AI-generated messages
Diff viewing - Rich diff display with syntax highlighting
Undo support - Safely undo AI changes
Branch management - Create and switch branches
Stash support - Stash and restore changes

Quick Start

# In interactive mode
>>> /diff          # Show current changes
>>> /commit        # Commit with AI message
>>> /undo          # Undo last commit

# Or use Python API
from praisonai.cli.features import GitIntegrationHandler

handler = GitIntegrationHandler()
handler.initialize(repo_path=".")
handler.show_status()

CLI Commands

/diff

Show current changes:

>>> /diff
╭─────────────────────────────────────────────────╮
│                   Changes                        │
├─────────────────────────────────────────────────┤
│ diff --git a/src/main.py b/src/main.py          │
│ @@ -10,6 +10,8 @@                                │
│  def main():                                     │
│ +    logger.info("Starting application")         │
│ +    config = load_config()                      │
│      app = Application()                         │
╰─────────────────────────────────────────────────╯

/commit

Commit with AI-generated message:

>>> /commit
Analyzing changes...

Generated commit message:
  feat(main): Add logging and config loading

  - Added logger.info call at startup
  - Added config loading before app initialization

[C]ommit / [E]dit message / [A]bort? c

✓ Committed: abc1234 - feat(main): Add logging and config loading

/undo

Undo the last commit:

>>> /undo
Undo last commit: "feat(main): Add logging and config loading"?
[Y]es / [N]o? y

✓ Commit undone. Changes are now staged.

Operator slash commands

Five /git-* commands drive GitManager directly from a praisonai code session.

>>> /git-status              # branch + staged/modified/untracked files
>>> /git-diff [--staged]     # uncommitted diff (or the staged diff)
>>> /git-log [n]             # last n commits (default 10)
>>> /git-commit [message]    # stage + commit; message auto-generated when omitted
>>> /git-undo                # undo the last commit, keeping changes in the tree

These are operator commands, not agent tools. Committing is a decision, not a step the model should take on its own — so the agent can’t call them. The same reasoning keeps /map operator-only.

They sit alongside the older /diff, /commit, /undo — the /git-* names are the explicit, git-scoped surface backed by GitManager (get_status, get_diff_content, get_log, commit, undo).

/git-status parsing was fixed alongside these commands: get_status() previously ran .strip() on the whole porcelain output, eating the leading space of the first line, so " M a.txt" parsed as status "M " and path ".txt" — reported as staged. It now strips only trailing newlines, so " M a.txt" is correctly modified, not staged.

Python API

Basic Usage

from praisonai.cli.features import GitIntegrationHandler

# Initialize
handler = GitIntegrationHandler()
git = handler.initialize(repo_path="/path/to/repo")

# Check if it's a git repo
if git.is_repo:
    print("Git repository detected")

Status

# Get repository status
status = handler.show_status()

print(f"Branch: {status.branch}")
print(f"Staged files: {status.staged_files}")
print(f"Modified files: {status.modified_files}")
print(f"Untracked files: {status.untracked_files}")
print(f"Is clean: {status.is_clean}")

Diff

# Show diff
diff_content = handler.show_diff()

# Show staged diff only
staged_diff = handler.show_diff(staged=True)

# Get diff for specific file
file_diff = git.get_diff_content(file_path="src/main.py")

Commit

# Commit with auto-generated message
commit = handler.commit()
print(f"Committed: {commit.short_hash} - {commit.message}")

# Commit with custom message
commit = handler.commit(message="fix: resolve null pointer exception")

# Commit without auto-staging
commit = handler.commit(auto_stage=False)

Undo

# Undo last commit (soft reset - keeps changes staged)
success = handler.undo(soft=True)

# Hard undo (discards changes)
success = handler.undo(soft=False)

Log

# Show commit log
commits = handler.show_log(count=10)

for commit in commits:
    print(f"{commit.short_hash} {commit.message} ({commit.author})")

Git Manager

For more control, use GitManager directly:

from praisonai.cli.features.git_integration import GitManager

git = GitManager(repo_path="/path/to/repo")

# Stage files
git.stage_files(["src/main.py", "src/utils.py"])
git.stage_files()  # Stage all

# Create commit
commit = git.commit("feat: add new feature")

# Branch operations
git.create_branch("feature/new-feature")
git.checkout_branch("main")
branches = git.get_branches()

# Stash
git.stash(message="WIP: working on feature")
git.stash_pop()

# Undo
git.undo_last_commit(soft=True)

Commit Message Generation

Automatic Generation

from praisonai.cli.features.git_integration import CommitMessageGenerator

generator = CommitMessageGenerator(use_ai=False)

# Generate from diff
diff_content = git.get_diff_content(staged=True)
message = generator.generate(diff_content)

# With context
message = generator.generate(
    diff_content,
    context="Fixing the authentication bug",
    style="conventional"  # or "simple", "detailed"
)

Message Styles

Conventional (default):

feat(auth): Add password validation

- Added regex pattern for password strength
- Added error messages for weak passwords

Simple:

Add password validation

Detailed:

feat(auth): Add password validation

- Added regex pattern for password strength
- Added error messages for weak passwords

+45 -12 lines in 2 files

Diff Viewer

Rich Display

from praisonai.cli.features.git_integration import DiffViewer

viewer = DiffViewer()

# Display diff with syntax highlighting
viewer.display_diff(diff_content, title="My Changes")

# Display status
viewer.display_status(status)

# Display log
viewer.display_log(commits)

Output Example

╭─────────────────────────────────────────────────╮
│              📊 Git Status                       │
├─────────────────────────────────────────────────┤
│ Category      │ Files                           │
├───────────────┼─────────────────────────────────┤
│ Branch        │ main                            │
│ Staged        │ 2                               │
│ Modified      │ 1                               │
│ Untracked     │ 0                               │
│ Ahead/Behind  │ +1 / -0                         │
╰─────────────────────────────────────────────────╯

Integration with Autonomy Modes

Git operations respect autonomy settings:

from praisonai.cli.features import (
    GitIntegrationHandler,
    AutonomyModeHandler
)

autonomy = AutonomyModeHandler()
autonomy.initialize(mode="suggest")

git = GitIntegrationHandler()
git.initialize()

# In suggest mode, commit requires approval
# In auto_edit mode, commit is auto-approved
# In full_auto mode, all git operations are auto-approved

Best Practices

Safe Workflow

Review diff first - Always check /diff before committing
Use meaningful messages - Edit AI messages if needed
Commit frequently - Small, focused commits
Use branches - Create branches for experiments

Commit Message Guidelines

# Good: Specific and descriptive
"feat(api): Add rate limiting to /users endpoint"

# Bad: Vague
"Update code"

Undo Strategy

# Soft undo - keeps changes for editing
handler.undo(soft=True)

# Hard undo - only for discarding mistakes
handler.undo(soft=False)  # Use with caution!

Configuration

Environment Variables

# Default commit message style
export PRAISONAI_COMMIT_STYLE=conventional

# Auto-commit after AI changes
export PRAISONAI_AUTO_COMMIT=false

# Git author for AI commits
export PRAISONAI_GIT_AUTHOR="PraisonAI <ai@praison.ai>"

Git Config

# Set up git for AI commits
git config user.name "Your Name"
git config user.email "you@example.com"

# Optional: Sign AI commits
git config commit.gpgsign true

Error Handling

from praisonai.cli.features.git_integration import GitManager

git = GitManager(repo_path="/path/to/repo")

# Check if repo exists
if not git.is_repo:
    print("Not a git repository")
    return

# Handle commit errors
commit = git.commit("message")
if commit is None:
    print("Commit failed - check for conflicts or empty changes")

Slash Commands - /diff, /commit, /undo
Autonomy Modes - Control git operation approval
Commit - Detailed commit documentation

​Git Integration

​Overview

​Quick Start

​CLI Commands

​/diff

​/commit

​/undo

​Operator slash commands

​Python API

​Basic Usage

​Status

​Diff

​Commit

​Undo

​Log

​Git Manager

​Commit Message Generation

​Automatic Generation

​Message Styles

​Diff Viewer

​Rich Display

​Output Example

​Integration with Autonomy Modes

​Best Practices

​Safe Workflow

​Commit Message Guidelines

​Undo Strategy

​Configuration

​Environment Variables

​Git Config

​Error Handling

​Related Features

Git Integration

Overview

Quick Start

CLI Commands

/diff

/commit

/undo

Operator slash commands

Python API

Basic Usage

Status

Diff

Commit

Undo

Log

Git Manager

Commit Message Generation

Automatic Generation

Message Styles

Diff Viewer

Rich Display

Output Example

Integration with Autonomy Modes

Best Practices

Safe Workflow

Commit Message Guidelines

Undo Strategy

Configuration

Environment Variables

Git Config

Error Handling

Related Features