Git history intelligence powered by AI. Use when the user asks about git history, commit messages, branch names, repo insights, code archaeology, or wants to...
---
name: gitrama
description: >
Git history intelligence powered by AI. Use when the user asks about git history,
commit messages, branch names, repo insights, code archaeology, or wants to understand
what happened in a codebase. Triggers on: "git history", "commit message", "branch name",
"who changed", "what happened", "repo summary", "code archaeology", "semantic search git",
"generate commit", "smart commit", "git log analysis", "contributor insights".
version: 1.0.0
homepage: https://gitrama.ai
metadata:
openclaw:
emoji: "🌿"
requires:
bins:
- git
- pip
binsAnyOf:
- python3
- python
install:
pip:
- gitrama
---
# 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
```
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/
don't have the plugin yet? install it then click "run inline in claude" again.