Skill: ahmaxdev/gitrama (version 1.0.1)

--- 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/


Security scan verdicts — ClawScan: clean | static analysis:  | VirusTotal: suspicious | SkillSpector: suspicious (HIGH)