Gitrama is a CLI-based intelligence layer that brings AI-powered semantic search and automated repo insights to your local git history.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install gitrama
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install gitrama using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Gitrama?
Gitrama is a powerful addition to the Openclaw Skills ecosystem designed for developers who need deeper insights into their version control history. By integrating an embedded AI assistant known as AskGIT, it allows users to perform semantic searches across their repository, enabling a level of code archaeology that goes far beyond standard git logs. It transforms the way you interact with your codebase by treating git history as a searchable, conversational database.
Built as a lightweight CLI tool, Gitrama bridges the gap between raw git data and actionable intelligence. It automatically handles the heavy lifting of gathering context from branches, commits, and diffs, sending them to a secure server-side API for processing. This ensures that users can leverage advanced AI capabilities without the need for complex local setups or managing individual API keys, making it a seamless fit for any professional development environment.
Gitrama Use Cases
- Performing semantic searches to find specific changes or logic updates within large codebases.
- Generating standardized, professional conventional commit messages based on staged changes.
- Conducting deep-dive code archaeology to understand the 'why' and 'who' behind historical architecture shifts.
- Automating the creation of descriptive branch names from simple task descriptions.
- Summarizing release notes and identifying potential breaking changes between specific tags or versions.
How Gitrama Works
- The user initiates a command through the CLI, such as
gtr chatorgtr commit. - Gitrama performs a series of local git subprocess calls to collect relevant context, including file trees, diffs, and commit metadata.
- The gathered context is packaged and sent via a secure POST request to the Gitrama processing engine.
- The AI analyzes the repository context and generates a natural language response or specific git artifact.
- The result is streamed back to the user's terminal, providing immediate insights or performing the requested action.
Gitrama Setup
Gitrama is a straightforward addition to your Openclaw Skills toolkit. Ensure you have python and git installed before proceeding.
# Install Gitrama via PyPI
pip install gitrama
# Verify the installation
gtr version
# Optional: Configure local settings
gtr config
Gitrama Data Schema & Taxonomy
Gitrama organizes and processes repository data dynamically to maintain high context relevance.
| Data Type | Collection Method | Purpose |
|---|---|---|
| Git Context | Local Subprocess | Gathers branch info, diffs, and tree structure. |
| Conversation History | Local Cache | Maintains up to 40 messages for multi-turn AI chat. |
| Metadata | API Request | Tracks repo patterns and contributor activity for insights. |
| Credentials | None | No local API keys are required for core functionality. |
Gitrama Advanced Features
- AskGIT Multi-turn Support: Maintains a history of up to 40 messages to provide deep contextual continuity during long research sessions.
- Intelligent Context Gathering: Automatically executes up to 10 distinct git commands to build a comprehensive view of the repo without manual user input.
- Conventional Commit Enforcement: Analyzes staged diffs to ensure all generated commit messages follow industry-standard prefixes like feat, fix, and docs.
- Automated Branch Scaffolding: Supports type prefixes such as feature/, bugfix/, and hotfix/ to maintain clean repository structures.
SKILL.md
Loading
Related Openclaw Skills
DFYX Code Security Review
An advanced white-box security auditing expert that performs deep data flow analysis and business logic verification to identify high-risk code vulnerabilities.
Git Sentinel (Code Reviewer)
A specialized AI agent skill that transforms your assistant into a merciless Senior Software Engineer and Security Auditor for rigorous code gatekeeping.
Daolv Hotel Booking Assistant
An AI-driven booking decision assistant that leverages MCP protocols to fetch real-time hotel data, compare room rates, and assess cancellation risks.
Suno Music Generation
An advanced music generation skill that interfaces with Suno to create full songs, custom lyrics, and instrumental tracks via a self-hosted API.
Architecture Research
An advanced AI agent skill designed to analyze source code, uncover design rationale, and generate professional ELK-based architecture diagrams.
Diagrams
Generate high-fidelity visual flowcharts, architecture diagrams, and system maps from structured JSON using the ELK layout engine.
Featured*
