Skip to content

v1.0.0 — "First Light" - Repository intelligence, delivered to your IDE.

Latest
Latest

Choose a tag to compare

View all tags
@amaxgtr amaxgtr released this 03 Mar 14:32
· 23 commits to main since this release
v1.0.0
fccfe5b
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

🌿 Gitrama MCP Server v1.0.0

AI-powered Git intelligence for your IDE — the first stable release.

What's New

11 MCP Tools

Your AI assistant can now call Gitrama directly from Cursor, Claude Desktop, Claude Code, VS Code, Windsurf, or Zed:

Category Tools
Repo Intelligence gitrama_ask — natural language Q&A about your codebase (ownership, history, risk, changes)
Commit Intelligence gitrama_commit · gitrama_stage_and_commit · gitrama_commit_quality
Branch Management gitrama_branch · gitrama_branch_suggest
PR & Changelog gitrama_pr · gitrama_changelog
Workflow Streams gitrama_stream_status · gitrama_stream_switch · gitrama_stream_list

4 AI Providers

Choose the backend that fits your security requirements:

  • Gitrama hosted — free tier (50 req/day), zero config
  • OpenAI — bring your own key
  • Anthropic — bring your own key
  • Ollama — fully local, air-gapped, zero data leaves your machine

7 IDEs Supported

Cursor · Claude Desktop · Claude Code · VS Code (Copilot) · Windsurf · Zed · any MCP-compatible client

Workflow Streams

Context-aware commit and branch generation based on your current workflow: hotfix, wip, review, experiment. Streams shape AI output — hotfix stream produces urgent conventional commits, experiment stream uses exploratory prefixes.

Streamable HTTP Transport

Run the MCP server over HTTP for CI/CD pipelines and remote deployments:

GTR_MCP_TRANSPORT=streamable-http GTR_MCP_PORT=8765 gitrama-mcp

Security

This release includes a comprehensive security policy (SECURITY.md):

  • No file contents are ever read — only Git metadata (diffs, logs, blame, file names)
  • No environment variables or credentials are accessed
  • Tokens are SHA-256 hashed before server-side storage
  • MCP server runs via stdio — no open network ports
  • Vulnerability reporting — security@gitrama.ai with 48-hour response SLA

Full data flow tables, infrastructure disclosure, and enterprise security options are documented in SECURITY.md.

CI/CD

Automated testing is now live:

  • pytest — unit tests across config, AI client, token validation, commit quality, branch naming, PR generation, streams, and health checks
  • GitHub Actions — matrix testing across Ubuntu, macOS, Windows x Python 3.9-3.12
  • ruff — linting on every push and PR
  • pip-audit — dependency vulnerability scanning

Install

pip install gitrama-mcp

Then add to your IDE config:

{ "mcpServers": { "gitrama": { "command": "gitrama-mcp" } } }

Run gtr setup to get your free API token, or configure BYOK/Ollama.

What's Next

  • GitHub Actions integration (gtr scan on push to main)
  • PR risk scoring via webhook
  • Repository Stability Index
  • Continuity Risk detection
  • Boundary Entropy analysis
  • Enterprise dashboard at dashboard.gitrama.ai

Links

Built by Alfonso Harding · gitrama.ai 🌿

Assets 2
Loading