GitDive

CLI tool for natural language conversations with git repository history. Index commits and ask questions about your project's evolution using a local llm.

Prerequisites

• Python 3.9+
• Ollama with a compatible model. You will need a chat model and an embedding model.

  ollama pull phi3:3.8b
  ollama pull nomic-embed-text:v1.5 

Installation

pip install gitdive

Usage

Index a repository:

gitdive index                    # Current directory
gitdive index /path/to/repo      # Specific repository

Ask questions:

gitdive ask "What changed in the authentication system?"
gitdive ask "Who worked on the API endpoints?"
gitdive ask "When was the database schema last modified?"

Cleanup:

gitdive cleanup  # Remove stored index

Configuration

Configure via environment variables:

export GITDIVE_LLM_MODEL="llama3.1:8b"              # Default: phi3:3.8b
export GITDIVE_OLLAMA_URL="http://localhost:11434"        # Default
export GITDIVE_LLM_TIMEOUT="300"                    # Default: 360

# Embedding model configuration
export GITDIVE_EMBEDDING_MODEL="nomic-embed-text:v1.5" # Default
export GITDIVE_EMBEDDING_OLLAMA_URL="http://localhost:11434" # Default
export GITDIVE_EMBEDDING_TIMEOUT="300"              # Default: 360

Indexes are stored in ~/.gitdive/repos/

Requirements

• Python 3.9+
• Git repository
• Ollama with compatible models

License

Apache License 2.0