Skip to content

cheGi Documentation

The ultimate Git companion. Type less, do more.

cheGi is a command-line tool for developers who work with multiple Git repositories. It gives you a fast workspace overview, safer commits, and shortcuts for everyday Git tasks.

Command Reference

Command Description
auth Manage token-based authentication for GitHub and GitLab
branch Full branch manager — list, create, switch, merge, rename, delete, sync, info
clone Clone repositories with smart defaults (submodules, .gitignore, .chegi/)
co / br / ci / st Git alias pass-through commands for checkout, branch, commit, status
commit Secure replacement for git commit with guided style selection
completions Generate shell completion scripts (bash, zsh, fish, powershell)
config Manage workspace settings, mirrors, and sensitive patterns
config git View and modify Git global configuration
doctor Comprehensive project health check
guard Check staged files for sensitive data before committing
hooks Install Git hooks (pre-commit, pre-push) with automatic guard scanning
info Quick project status dashboard with Rich terminal UI
init Initialize .chegi/ project configuration directory
new Scaffold new Git projects from scratch
repo List and browse GitHub repositories
reword Reword a commit message interactively
scan Scan a directory tree for Git repositories and report their status
setup Install and configure a development environment
sync Safely sync the current branch with its remote
upgrade Check for and install the latest version of cheGi

Quick Examples

chegi scan ~/projects                # Scan workspace for Git repos
chegi guard                          # Check staged files for secrets
chegi commit                         # Guided secure commit
chegi branch                         # Interactive branch manager
chegi clone user/repo                # Clone with smart defaults
chegi new my-app -t python           # Scaffold a new project
chegi info                           # Project status dashboard
chegi doctor                         # Full health check
chegi hooks install                  # Install pre-commit guard
chegi upgrade --check                # Check for cheGi updates
chegi completions bash               # Generate bash completions
chegi sync                           # Safe pull-rebase-push

Global Options

These flags are available on every chegi command.

Option Short Description
--version -v Show the cheGi version and exit

Example:

chegi --version
chegi -v

Configuration

Workspace settings are stored in .chegi.json or .chegi/config.json.

Security

More