gitrama

What This Skill Does

Gitrama is a powerful CLI-integrated agent skill designed to bridge the gap between raw Git history and human-understandable insights. By leveraging the AskGIT engine, this skill provides semantic intelligence directly from your local repository. It acts as an archaeology expert for your codebase, allowing users to query repository history using natural language, generate conventional commit messages, and craft descriptive branch names based on intent. Gitrama abstracts the complexity of git log and git diff by performing local context gathering via subprocesses, sending that data to api.gitrama.ai to provide human-readable summaries, contributor patterns, and technical debt analysis without requiring users to manually manage API keys.

Installation

To integrate Gitrama into your OpenClaw agent, execute the following command in your terminal: clawhub install openclaw/skills/skills/ahmaxdev/gitrama Once installed, verify the configuration by running gtr version. Ensure you have Git initialized in the directory you intend to query, as the skill relies on local Git subprocess calls to generate context for the AI engine.

Use Cases

• Code Archaeology: Quickly identify why a specific change was made to the authentication module months ago.
• Commit Standardization: Automatically generate conventional commits (feat:, fix:) based on your current staged changes.
• Onboarding Assistance: New developers can ask the agent to summarize recent major refactors or identify the primary contributors to a specific directory.
• Process Automation: Streamline developer workflow by having the AI suggest precise branch names based on task descriptions provided in natural language.

Example Prompts

1. "Who has been the most active contributor to the API service module over the last quarter?"
2. "Generate a conventional commit message for my staged changes that adds OAuth2 support to the login flow."
3. "Explain the reasoning behind the breaking changes introduced in the last two weeks regarding the database schema."

Tips & Limitations

• Context Window: Gitrama works best when the repository history is descriptive. The quality of AI analysis is directly proportional to the quality of your existing commit messages.
• Offline Usage: Since Gitrama relies on api.gitrama.ai for the intelligence layer, it requires an active internet connection to process queries.
• Privacy: While no API keys are stored locally, be mindful that your repository's local diffs and commit summaries are transmitted to the server for analysis. Use with caution in proprietary repositories containing extremely sensitive credentials.