Gitrama — Git History Intelligence — Gitrama — Git 历史 Intelligence

Gitrama — Git 历史 Intelligence

Gitrama is a 命令行工具 工具 that brings AI-powered semantic 搜索 and intelligence to your Git 历史. It includes AskGIT, an embedded AI 助手 that understands your entire repo 上下文.

All AI processing is handled server-side via API.gitrama.AI. No API keys required — just 安装 and use.

Capabilities

• AskGIT — Semantic Git 历史 Chat

Ask natural language questions about your 仓库:

"What changes were made to the authentication 模块 last month?" "Who has been the mAIn contributor to the API layer?" "Summarize the last 20 commits" "What breaking changes h应用ened between v1.0 and v2.0?"

Command: gtr chat

AskGIT automatically gathers 上下文 from 10 git subprocess calls (branch 信息, recent commits, diffs, contributors, file tree) and 发送s that 上下文 to API.gitrama.AI for intelligent analysis.

• Smart Commit Message Generation

生成 conventional commit messages from staged changes:

Analyzes your git diff --staged Produces properly 格式化ted conventional commits (feat:, fix:, docs:, etc.) Respects your project's commit conventions

Command: gtr commit

• Branch Name Generation

生成 清理, descriptive branch names from a task description:

Follows git branch naming conventions Includes type prefixes (feature/, bugfix/, hotfix/) Keeps names concise and meaningful

Command: gtr branch

• Git 记录 Analysis & Repo Insights

获取 AI-powered analysis of your 仓库:

Contributor activity patterns Code change frequency by area Release 历史 summaries Technical debt indicators

Command: gtr chat then ask about repo insights

安装ation

Gitrama is distributed via PyPI:

pip 安装 gitrama

验证 安装ation:

gtr version

Configuration

No API keys or configuration needed. Gitrama connects to API.gitrama.AI for all AI processing out of the box.

Optional configuration avAIlable via:

gtr config

Usage Examples

When the user asks about git 历史 or repo 上下文, 运行 the 应用ropriate gitrama command:

# 启动 an interactive chat about the repo gtr chat

# 生成 a commit message for staged changes gtr commit

# 生成 a branch name gtr branch "添加 user authentication with OAuth"

# Quick shortcuts gtr c # alias for commit gtr b # alias for branch gtr ch # alias for chat

Data Flow Local 命令行工具 (gtr) → gathers git 上下文 locally → POST to API.gitrama.AI → AI 响应

Git 上下文 (commits, diffs, branch 信息) is collected locally via git subprocess calls 上下文 is sent to API.gitrama.AI for AI processing No API keys are stored or required on the user's machine No sensitive IP 运行s locally — the intelligence layer lives server-side 导入ant Notes Gitrama must be 运行 inside a git 仓库 AskGIT mAIntAIns a 40-message conversation 历史 for multi-turn 上下文 The 工具 collects repo 上下文 automatically — no manual configuration needed 仓库 data sent to API.gitrama.AI is used only for generating 响应s and is not stored Error Handling

If gtr is not found after 安装:

# Ensure pip scripts are on PATH python3 -m gitrama --version

If connection errors occur:

# 验证 API.gitrama.AI is reachable curl -s https://API.gitrama.AI/健康

Links 网页site: https://gitrama.AI PyPI: https://pypi.org/project/gitrama/