cheGi

The ultimate Git companion. Type less, do more.

cheGi is a fast, developer-friendly CLI for managing Git across your entire workspace. Scan multiple repositories at once, catch secrets before they ship, sync branches safely, and automate the repetitive parts of your daily Git workflow — all from a single tool with a beautiful terminal UI.

cheGi donates 20% of all funding to charity — local aid, disaster relief, and community causes. See CHARITY.md for details.

Features

• Workspace scan — Discover Git repos concurrently and get a unified status overview
• Branch manager — List, create, switch, merge, rename, delete, sync branches
• Smart clone — Clone repos with user/repo shorthand, submodule init, smart .gitignore
• Secure commit — Guided commit with security checks and multiple commit styles
• Security guard — Detect sensitive files (.env, keys, tokens) in staged changes
• Strict guard — Scan both staged and unstaged files
• History scan — Scan all Git history across branches for leaked secrets
• Git hooks — Install pre-commit/pre-push hooks with automatic guard scanning
• Safe sync — Pull with rebase, push, and auto-stash when your tree is dirty
• Commit reword — Update commit messages interactively, including older commits
• Project scaffolding — Create new Git projects with .gitignore, license, README
• Health check — Comprehensive project health check with actionable suggestions
• Environment setup — Bootstrap dev toolchains (Python, Go, Rust, and more)
• Gitignore generator — Build .gitignore files from technology presets
• Shell completions — Generate completions for bash, zsh, fish, powershell
• GitHub integration — Browse repos, clone your own repos, push new projects
• Token auth — Encrypted token storage for GitHub and GitLab
• Self-upgrade — Auto-check for updates and upgrade from the CLI
• Flexible config — Per-workspace settings via .chegi.json or .chegi/ directory
• First-run wizard — Guided setup on first use (Git identity, SSH keys, theme, auth)

Requirements

• Python 3.8+
• Git installed and available on your PATH

Installation

All methods

Platform support: Linux (amd64, arm64), macOS (Intel + Apple Silicon), Windows (amd64).

From source (development)

git clone https://github.com/Ad-alwer/cheGi.git
cd cheGi
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e ".[dev]"

Quick Start

# Scan all repositories under your projects folder
chegi scan ~/projects

# Check staged files for secrets before committing
chegi guard

# Interactive branch manager
chegi branch

# Clone a repo with smart defaults
chegi clone user/repo

# Scaffold a new project
chegi new my-app -t python

# Project health check
chegi doctor

# Safe sync
chegi sync

# Self-upgrade
chegi upgrade --check

Commands

Full documentation: ad-alwer.github.io/cheGi

Run chegi --help or chegi <command> --help for built-in usage details.

Configuration

Settings are stored in .chegi.json or .chegi/config.json at the root of your project:

chegi config list
chegi config set max_depth 5
chegi config exclude-add node_modules

• Configuration Guide — full reference and troubleshooting
• Security Guide — guard, hooks, and CI integration

See CONTRIBUTING.md for development setup and SECURITY.md for the security policy.

Development

pip install -e ".[dev]"
pytest -v
ruff check src tests
ruff format --check src tests
mkdocs build --strict

License

MIT — see LICENSE.