Gitrama — Git History Intelligence#

Gitrama is a CLI tool that brings AI-powered semantic search and intelligence to your Git history. It includes AskGIT, an embedded AI assistant that understands your entire repo context.

All AI processing is handled server-side via api.gitrama.ai. No API keys required — just install and use.

Capabilities#

1. AskGIT — Semantic Git History Chat#

Ask natural language questions about your repository:

• "What changes were made to the authentication module last month?"
• "Who has been the main contributor to the API layer?"
• "Summarize the last 20 commits"
• "What breaking changes happened between v1.0 and v2.0?"

Command: gtr chat

AskGIT automatically gathers context from 10 git subprocess calls (branch info, recent commits, diffs, contributors, file tree) and sends that context to api.gitrama.ai for intelligent analysis.

2. Smart Commit Message Generation#

Generate conventional commit messages from staged changes:

• Analyzes your git diff --staged
• Produces properly formatted conventional commits (feat:, fix:, docs:, etc.)
• Respects your project's commit conventions

Command: gtr commit

3. Branch Name Generation#

Generate clean, descriptive branch names from a task description:

• Follows git branch naming conventions
• Includes type prefixes (feature/, bugfix/, hotfix/)
• Keeps names concise and meaningful

Command: gtr branch

4. Git Log Analysis & Repo Insights#

Get AI-powered analysis of your repository:

• Contributor activity patterns
• Code change frequency by area
• Release history summaries
• Technical debt indicators

Command: gtr chat then ask about repo insights

Installation#

Gitrama is distributed via PyPI:

bash

pip install gitrama

Verify installation:

bash

gtr version

Configuration#

No API keys or configuration needed. Gitrama connects to api.gitrama.ai for all AI processing out of the box.

Optional configuration available via:

bash

gtr config

Usage Examples#

When the user asks about git history or repo context, run the appropriate gitrama command:

bash

# Start an interactive chat about the repo
gtr chat

# Generate a commit message for staged changes
gtr commit

# Generate a branch name
gtr branch "add user authentication with OAuth"

# Quick shortcuts
gtr c   # alias for commit
gtr b   # alias for branch
gtr ch  # alias for chat

Data Flow#

text

Local CLI (gtr) → gathers git context locally → POST to api.gitrama.ai → AI response

• Git context (commits, diffs, branch info) is collected locally via git subprocess calls
• Context is sent to api.gitrama.ai for AI processing
• No API keys are stored or required on the user's machine
• No sensitive IP runs locally — the intelligence layer lives server-side

Important Notes#

• Gitrama must be run inside a git repository
• AskGIT maintains a 40-message conversation history for multi-turn context
• The tool collects repo context automatically — no manual configuration needed
• Repository data sent to api.gitrama.ai is used only for generating responses and is not stored

Error Handling#

If gtr is not found after install:

bash

# Ensure pip scripts are on PATH
python3 -m gitrama --version

If connection errors occur:

bash

# Verify api.gitrama.ai is reachable
curl -s https://api.gitrama.ai/health

Links#

• Website: https://gitrama.ai
• PyPI: https://pypi.org/project/gitrama/