How do I install the Gitrama skill?

Run npx skillmds@latest add johnalbertini14-glitch/gitrama in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Gitrama safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gitrama?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gitrama free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gitrama?

johnalbertini14-glitch (@johnalbertini14-glitch) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gitrama by johnalbertini14-glitch — Agent Skill

Name: Gitrama
Rating: 4.2 (5 reviews)
Author: johnalbertini14-glitch

Gitrama

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".

File contents

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:

pip install gitrama

Verify installation:

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:

gtr config

Usage Examples

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

# 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:

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

If connection errors occur:

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

Links

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

---name: gitramadescription: 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".---# Gitrama — Git History IntelligenceGitrama 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 ChatAsk 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 GenerationGenerate 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 GenerationGenerate 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 InsightsGet 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## InstallationGitrama is distributed via PyPI:```bashpip install gitrama```Verify installation:```bashgtr version```## ConfigurationNo API keys or configuration needed. Gitrama connects to api.gitrama.ai for all AI processing out of the box.Optional configuration available via:```bashgtr config```## Usage ExamplesWhen the user asks about git history or repo context, run the appropriate gitrama command:```bash# Start an interactive chat about the repogtr chat# Generate a commit message for staged changesgtr commit# Generate a branch namegtr branch "add user authentication with OAuth"# Quick shortcutsgtr c # alias for commitgtr b # alias for branchgtr 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 HandlingIf `gtr` is not found after install:```bash# Ensure pip scripts are on PATHpython3 -m gitrama --version```If connection errors occur:```bash# Verify api.gitrama.ai is reachablecurl -s https://api.gitrama.ai/health```## Links- Website: https://gitrama.ai- PyPI: https://pypi.org/project/gitrama/

Frequently asked questions