Gitrama

Gitrama is a repository risk and intelligence platform designed to detect structural degradation in codebases before failures occur. It provides developers with AI-powered tools to identify fragile files, security issues, and architectural drift by analyzing Git history rather than relying on dashboards. The platform focuses on three key structural signals—continuity risk, boundary entropy, and recurrence risk—that together predict potential failures and measure codebase decay over time.

The tool offers a suite of features accessible via a command-line interface (CLI) and integrates with multiple development environments, including Cursor, Claude Desktop, Claude Code, VS Code, Windsurf, Zed, and terminal. Gitrama includes commands such as 'gtr scan' for structural health scans, 'gtr diff' for risk-annotated diffs with overlays of risk scores, churn rates, last touched by, and test coverage signals, and 'gtr review' for AI-driven code reviews that return severity-graded findings on security, correctness, risk, and coupling. Additional capabilities include generating conventional commit messages from staged diffs, creating full pull request descriptions, answering repository questions in natural language, and generating smart branch names from task descriptions. The platform also supports context-aware workflow streams, adapting conventions for different development scenarios like hotfixes or experiments.

Gitrama is delivered through a CLI and an MCP server, installable via pip. It does not require an agent, daemon, or additional infrastructure. Users can configure it with a free token for a 14-day unlimited trial or use their own OpenAI, Anthropic, or Ollama API keys for AI features. The platform offers a free tier for individual developers, which includes the full CLI, MCP tools, support for seven IDEs, three workflow streams, and limited access to repository Q&A features. A Pro plan is available for a monthly fee, targeting developers who commit daily and require expanded capabilities.

By focusing on structural health and providing actionable intelligence before code is pushed, Gitrama aims to help engineering teams maintain codebase stability and prevent failures driven by architectural decay.