Getting Started

Installation Guide

GitSage is a lightweight, language-agnostic CLI tool that integrates directly with your Git workflow. Supports Python, JavaScript, TypeScript, Go, Rust, and more. Install it in seconds and start generating intelligence for your repository.

Overview

GitSage uses advanced Large Language Models (LLMs) to analyze your staged changes. It doesn't just describe code; it understands the intent, impact, and reach of your commits.

pip, uv, poetry, npm, pnpm, yarn, curl

Python 3.10+ · Node.js 18+

Git 2.x integration

Works with any language repo

Installation

v1.1.0 stable

GitSage is available across all major package managers. Pick your preferred ecosystem — the binary is identical regardless of how you install it.

Install

pip install gitsage-cli

Python· package: gitsage-cli

Upgrade

pip install --upgrade gitsage-cli

Python· package: gitsage-cli

Package names

gitsage-cliPython (pip / uv / poetry)

gitsage-cliNode (npm / pnpm / yarn)

curl install.shShell (macOS & Linux)

Binary from GitHub ReleasesWindows

API Configuration

GitSage uses centralized intelligence by default. Acquire your production API key by signing up on ourGitSage Portaland configure your environment:

bash

# Authenticate via GitSage CLI (Recommended)
gitsage auth --token YOUR_GITSAGE_KEY

Security Warning: Never share your API keys or commit them to public repositories. GitSage stores keys locally in your secure user configuration directory.

Verification & Quick Start

Run Analysis

bash

gitsage

Commit shorthand

bash

gitsage -c