{"skill":{"slug":"gitrama","displayName":"Gitrama — Git History Intelligence","summary":"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...","description":"---\nname: gitrama\ndescription: >\n  Git history intelligence powered by AI. Use when the user asks about git history,\n  commit messages, branch names, repo insights, code archaeology, or wants to understand\n  what happened in a codebase. Triggers on: \"git history\", \"commit message\", \"branch name\",\n  \"who changed\", \"what happened\", \"repo summary\", \"code archaeology\", \"semantic search git\",\n  \"generate commit\", \"smart commit\", \"git log analysis\", \"contributor insights\".\nversion: 1.0.0\nhomepage: https://gitrama.ai\nmetadata:\n  openclaw:\n    emoji: \"🌿\"\n    requires:\n      bins:\n        - git\n        - pip\n      binsAnyOf:\n        - python3\n        - python\n    install:\n      pip:\n        - gitrama\n---\n\n# Gitrama — Git History Intelligence\n\nGitrama 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.\n\nAll AI processing is handled server-side via `api.gitrama.ai`. No API keys required — just install and use.\n\n## Capabilities\n\n### 1. AskGIT — Semantic Git History Chat\nAsk natural language questions about your repository:\n- \"What changes were made to the authentication module last month?\"\n- \"Who has been the main contributor to the API layer?\"\n- \"Summarize the last 20 commits\"\n- \"What breaking changes happened between v1.0 and v2.0?\"\n\n**Command:** `gtr chat`\n\nAskGIT 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.\n\n### 2. Smart Commit Message Generation\nGenerate conventional commit messages from staged changes:\n- Analyzes your `git diff --staged`\n- Produces properly formatted conventional commits (feat:, fix:, docs:, etc.)\n- Respects your project's commit conventions\n\n**Command:** `gtr commit`\n\n### 3. Branch Name Generation\nGenerate clean, descriptive branch names from a task description:\n- Follows git branch naming conventions\n- Includes type prefixes (feature/, bugfix/, hotfix/)\n- Keeps names concise and meaningful\n\n**Command:** `gtr branch`\n\n### 4. Git Log Analysis & Repo Insights\nGet AI-powered analysis of your repository:\n- Contributor activity patterns\n- Code change frequency by area\n- Release history summaries\n- Technical debt indicators\n\n**Command:** `gtr chat` then ask about repo insights\n\n## Installation\n\nGitrama is distributed via PyPI:\n\n```bash\npip install gitrama\n```\n\nVerify installation:\n\n```bash\ngtr version\n```\n\n## Configuration\n\nNo API keys or configuration needed. Gitrama connects to api.gitrama.ai for all AI processing out of the box.\n\nOptional configuration available via:\n\n```bash\ngtr config\n```\n\n## Usage Examples\n\nWhen the user asks about git history or repo context, run the appropriate gitrama command:\n\n```bash\n# Start an interactive chat about the repo\ngtr chat\n\n# Generate a commit message for staged changes\ngtr commit\n\n# Generate a branch name\ngtr branch \"add user authentication with OAuth\"\n\n# Quick shortcuts\ngtr c   # alias for commit\ngtr b   # alias for branch\ngtr ch  # alias for chat\n```\n\n## Data Flow\n\n```\nLocal CLI (gtr) → gathers git context locally → POST to api.gitrama.ai → AI response\n```\n\n- Git context (commits, diffs, branch info) is collected locally via git subprocess calls\n- Context is sent to api.gitrama.ai for AI processing\n- No API keys are stored or required on the user's machine\n- No sensitive IP runs locally — the intelligence layer lives server-side\n\n## Important Notes\n\n- Gitrama must be run inside a git repository\n- AskGIT maintains a 40-message conversation history for multi-turn context\n- The tool collects repo context automatically — no manual configuration needed\n- Repository data sent to api.gitrama.ai is used only for generating responses and is not stored\n\n## Error Handling\n\nIf `gtr` is not found after install:\n```bash\n# Ensure pip scripts are on PATH\npython3 -m gitrama --version\n```\n\nIf connection errors occur:\n```bash\n# Verify api.gitrama.ai is reachable\ncurl -s https://api.gitrama.ai/health\n```\n\n## Links\n\n- Website: https://gitrama.ai\n- PyPI: https://pypi.org/project/gitrama/\n","topics":["Log Analysis","Git","Message"],"tags":{"latest":"1.0.1"},"stats":{"comments":0,"downloads":404,"installsAllTime":15,"installsCurrent":0,"stars":1,"versions":2},"createdAt":1771967102493,"updatedAt":1778992970635},"latestVersion":{"version":"1.0.1","createdAt":1771967909171,"changelog":"- Removed the dependency on API keys; configuration step for ANTHROPIC_API_KEY eliminated.\n- Updated documentation to clarify that all AI processing is handled server-side via api.gitrama.ai with no user API key required.\n- Revised metadata to remove the API key requirement for installation and usage.\n- Switched script path from scripts/verify.sh to script/verify.sh for improved consistency.\n- Provided more details in the documentation about data flow and privacy: all intelligence and analysis now occur on the server, with no sensitive data processed locally.","license":null},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"ahmaxdev","userId":"s171nbrn98g06evy28ez523red88503e","displayName":"Alfonso Harding Jr","image":"https://avatars.githubusercontent.com/u/137835945?v=4"},"moderation":null}