gitrama_stream_switch
Switch to a different Gitrama stream (workflow context).
Creates a new stream or switches to an existing one. Streams help
the AI understand what you're working on for better suggestions.
Args:
name: Stream name (e.g., "auth-refactor", "payment-v2").
description: Optional description of the stream's purpose.
gitrama_stream_list
List all Gitrama streams in the current repository.
Shows all defined streams with their names, descriptions,
and associated branches. The active stream is highlighted.
gitrama_health
Check the Gitrama AI server health status.
Verifies connectivity to the Gitrama AI API and returns
the current server status and MCP server version. Useful for
diagnosing issues when other commands fail.
gitrama_status
Show the working tree status with AI interpretation.
Displays the current git status including staged, unstaged,
and untracked files with AI-powered context about the changes.
gitrama_diff
Show a risk-annotated diff of current changes.
Overlays Gitrama's structural intelligence on top of the raw git diff —
risk scores, churn rates, coupling gaps, and contributor context for
every changed file. Opens a browser panel with the full analysis.
Args:
target: Branch or commit to diff against (default: working tree).
staged: If True, diff staged changes only (default: all changes).
gitrama_review
Run an AI code review on current changes before committing.
Sends your diff and repo intelligence to Gitrama's review engine.
Returns severity-graded findings — security, correctness, risk,
coupling — plus a verdict and suggested commit message.
Runs before you push, not after. Catches issues at the right time.
Args:
mode: Review scope — one of:
"staged" — staged changes only (default)
"uncommitted" — all uncommitted changes
"quick" — critical issues only
"full" — full review with suggestions
gitrama_unstage
Remove files from the staging area without discarding changes.
Moves files out of the git index back to the working tree.
Changes are preserved — nothing is lost.
Args:
files: Space-separated file paths to unstage. Leave empty for
interactive selection (CLI only).
all_files: If True, unstage everything currently staged.
gitrama_scan
Run a full structural health scan of the repository.
Scores every file for continuity risk, boundary entropy, and
recurrence patterns. Identifies coupling hotspots and contributor
concentration before they compound into failures.
Results are cached in last_scan.json for use by gtr diff and gtr review.
gitrama_push
Push the current branch to a remote repository.
Pushes committed changes to the specified remote. Optionally sets
the upstream tracking branch for new branches.
Args:
remote: Remote to push to (default: "origin").
branch: Branch to push (default: current branch).
force: If True, force push with --force-with-lease (safer than --force).
set_upstream: If True, sets the upstream tracking branch (-u flag).
Use this when pushing a new branch for the first time.