Basic Git Operations - CLI Aliases

This directory contains 15 essential Git operation aliases that provide simplified access to the most commonly used Git commands. Each alias is a standalone executable script with comprehensive help documentation, error handling, and real Git command execution.

Overview

Basic operations cover fundamental Git tasks that every developer needs on a daily basis. These commands are designed to be simple, safe, and intuitive while providing access to comprehensive Git functionality with all standard options.

All 15 Basic Commands:

gadd - Stage files and directories with comprehensive options
gbranch - List, create, and manage branches
gcheckout - Switch branches and checkout files/commits
gclone - Clone repositories with full Git clone options
gcommit - Create commits with extensive message and author options
gdiff - Show differences with formatting and filtering options
ginit - Initialize repositories with templates and configurations
glog - View commit history with filtering and graph visualization
gpop - Apply and manage stashed changes
gpull - Pull changes with merge and rebase options
gpush - Push commits with safety and upstream management
gremote - Comprehensive remote repository management
greset - Reset repository state with precision control
gstash - Stash changes with selective and advanced options
gstatus - Show repository status with detailed formatting

Pro Tip: Every command supports --help or -h for detailed usage information with comprehensive options!

All Options Are Real Git Options: Every option documented is a genuine Git command option - no custom flags that don't exist in Git.

Command Details

`gadd` - Stage Files

Purpose: Add files to the staging area in preparation for commit. Supports both specific files and bulk operations with comprehensive file validation.

Command: gadd [files...] [options]

Parameters:

[files...] - Optional list of files/directories to stage (defaults to all changes)

Essential Options:

-A, --all - Add all changes including new files and deletions
-u, --update - Add only modified and deleted files (no new files)
-p, --patch - Interactive patch mode for selective staging
-n, --dry-run - Show what would be added without actually adding
-v, --verbose - Show detailed output of what's being staged
-f, --force - Force add ignored files
--ignore-errors - Continue adding even if some files fail
-h, --help - Show detailed help information

Common Use Cases:

# Basic usage gadd # Stage all changes gadd --help # Show help # Specific files gadd src/app.js # Stage single file gadd src/ docs/ # Stage directories gadd "*.js" "*.css" # Stage by pattern # Advanced staging gadd -p # Interactive patch mode gadd -u # Only modified/deleted files gadd -A # All changes including new files gadd -n # Preview what would be added # Force operations gadd -f .gitignore # Force add ignored file gadd --ignore-errors src/ # Continue on errors

Related Commands: gstatus (check staging area), gcommit (commit staged files), greset (unstage files) MCP Tool: git_add

`gbranch` - Branch Management

Purpose: List existing branches or create new branches with validation and safety checks.

Command: gbranch [branch-name] [options]

Parameters:

[branch-name] - Optional name for new branch to create

Essential Options:

-a, --all - Show both local and remote branches
-r, --remotes - Show only remote branches
-d, --delete - Delete specified branch
-D, --force-delete - Force delete branch (even if unmerged)
-m, --move - Rename current branch
-c, --copy - Copy branch to new name
--merged - Show only merged branches
--no-merged - Show only unmerged branches
-h, --help - Show detailed help information

Common Use Cases:

# Basic usage gbranch # List all local branches gbranch --help # Show help # Branch listing gbranch -a # Show all branches (local + remote) gbranch -r # Show only remote branches gbranch --merged # Show merged branches gbranch --no-merged # Show unmerged branches # Branch creation gbranch feature/new-login # Create new branch gbranch hotfix/critical-bug # Create hotfix branch # Branch management gbranch -d old-feature # Delete merged branch gbranch -D experimental # Force delete branch gbranch -m new-name # Rename current branch gbranch -c backup-branch # Copy current branch

Related Commands: gcheckout (switch branches), gstatus (current branch), gpush (push branches) MCP Tool: git_branch

- `gcheckout` - Branch Switching

Purpose: Switch between branches or create new branches with automatic validation and safety checks.

Command: gcheckout [branch-name] [options]

Parameters:

[branch-name] - Branch name to switch to or create

Essential Options:

-b, --new-branch - Create and switch to new branch
-B, --force-branch - Force create branch (reset if exists)
-t, --track - Set up tracking with remote branch
--orphan - Create orphan branch (no commit history)
-f, --force - Force checkout (discard local changes)
-m, --merge - Merge local changes when switching
--detach - Switch to detached HEAD state
-h, --help - Show detailed help information

Common Use Cases:

# Basic usage gcheckout main # Switch to main branch gcheckout --help # Show help # Branch switching gcheckout feature/login # Switch to existing branch gcheckout - # Switch to previous branch gcheckout --detach HEAD~3 # Switch to detached HEAD # Branch creation gcheckout -b feature/new-ui # Create and switch to new branch gcheckout -b hotfix/bug origin/main # Create branch from remote gcheckout -B experimental # Force create branch # Advanced operations gcheckout -t origin/feature # Checkout and track remote branch gcheckout --orphan gh-pages # Create orphan branch gcheckout -f main # Force checkout (discard changes) gcheckout -m feature/update # Merge local changes when switching

Related Commands: gbranch (manage branches), gstatus (check state), gstash (save changes) MCP Tool: git_checkout

`gclone` - Repository Cloning

Purpose: Clone remote repositories with various options for different use cases and optimization.

Command: gclone [directory] [options]

Parameters:

- Required URL of repository to clone
[directory] - Optional target directory name

Essential Options:

--depth - Create shallow clone with limited history
--branch - Clone specific branch
--single-branch - Clone only one branch
--bare - Create bare repository (no working directory)
--mirror - Create mirror clone (includes all refs)
--recursive - Clone with all submodules
--jobs - Number of parallel jobs for submodules
-h, --help - Show detailed help information

Common Use Cases:

# Basic cloning gclone https://github.com/user/repo.git # Clone repository gclone --help # Show help # Specific directory gclone https://github.com/user/repo.git my-app # Clone to specific directory # Optimized cloning gclone --depth 1 https://github.com/user/repo.git # Shallow clone (latest commit only) gclone --branch main https://github.com/user/repo.git # Clone specific branch gclone --single-branch https://github.com/user/repo.git # Single branch only # Advanced cloning gclone --bare https://github.com/user/repo.git # Bare repository gclone --mirror https://github.com/user/repo.git # Mirror clone gclone --recursive https://github.com/user/repo.git # Include submodules gclone --jobs 4 --recursive https://github.com/user/repo.git # Parallel submodule clone

Related Commands: ginit (create repository), gremote (manage remotes), gpull (update) MCP Tool: git_clone

`gcommit` - Create Commits

Purpose: Create commits with comprehensive options for message handling, staging, and commit modifications.

Command: gcommit [message] [options]

Parameters:

[message] - Commit message (required unless using -m or --amend)

Essential Options:

-m, --message - Use given message as commit message
-a, --all - Stage all modified files and commit
--amend - Amend the last commit
--no-edit - Use previous commit message (with --amend)
-s, --signoff - Add Signed-off-by line
--author - Override commit author
--date - Override commit date
-n, --no-verify - Skip pre-commit and commit-msg hooks
--allow-empty - Allow empty commits
--allow-empty-message - Allow commits with empty messages
-v, --verbose - Show unified diff in commit message editor
-h, --help - Show detailed help information

Common Use Cases:

# Basic commits gcommit "fix: resolve login bug" # Standard commit gcommit -a "feat: add new feature" # Stage all and commit gcommit --help # Show help # Advanced commits gcommit --amend # Amend last commit gcommit -s "docs: update README" # Add signoff gcommit --allow-empty "trigger CI" # Empty commit gcommit --author "John Doe " "fix: bug" # Override author gcommit --date "2024-01-01" "feat: new feature" # Set specific date

Related Commands: gadd (stage files), gpush (upload commits), glog (view history) MCP Tool: git_commit

`gdiff` - Show Differences

Purpose: Display differences between files, commits, branches, and working directory with various formatting options.

Command: gdiff [options] [paths...]

Parameters:

[paths...] - Optional specific files or paths to compare

Essential Options:

--staged, --cached - Show staged changes
--name-only - Show only file names that changed
--stat - Show statistics (additions/deletions)
--color-words - Color changed words instead of lines
-w, --ignore-whitespace - Ignore whitespace changes
--unified - Number of context lines
--no-pager - Don't use pager for output
-h, --help - Show detailed help information

Common Use Cases:

# Basic differences gdiff # Show unstaged changes gdiff --help # Show help # Specific comparisons gdiff --staged # Show staged changes gdiff HEAD~1 # Compare with previous commit gdiff main feature-branch # Compare branches gdiff origin/main HEAD # Compare with remote # Formatted output gdiff --stat # Statistics summary gdiff --name-only # Just file names gdiff --color-words # Word-level highlighting gdiff -w # Ignore whitespace # File-specific gdiff src/app.js # Changes in specific file gdiff HEAD~2 HEAD src/ # Changes in directory over time

Related Commands: gstatus (overview), glog (commit history), gcheckout (view versions) MCP Tool: git_diff

[NEW] `ginit` - Initialize Repository

Purpose: Initialize new Git repositories with various configurations and optional initial setup.

Command: ginit [options]

Essential Options:

--bare - Create bare repository (no working directory)
--shared - Make repository group-writable
--template - Use custom template directory
--separate-git-dir - Separate .git directory
--initial-branch - Set initial branch name
-q, --quiet - Suppress output
-h, --help - Show detailed help information

Common Use Cases:

# Basic initialization ginit # Initialize current directory ginit --help # Show help # Advanced initialization ginit --bare # Bare repository (for servers) ginit --shared # Group-writable repository ginit --initial-branch main # Set main as initial branch # Custom configuration ginit --template ~/.git-templates # Use custom template ginit --separate-git-dir ../git-data # Separate git directory ginit -q # Quiet initialization

Related Commands: gclone (clone existing), gremote (add remotes), gcommit (first commit) MCP Tool: git_init

`glog` - Commit History

Purpose: Display commit history with various formatting options, filtering, and search capabilities.

Command: glog [options] [paths...]

Parameters:

[paths...] - Optional specific files or paths to show history for

Essential Options:

--oneline - Compact one-line format
--graph - Show ASCII graph of branch/merge history
--stat - Show files changed in each commit
--patch - Show full diff for each commit
-n - Limit number of commits shown
--since - Show commits since date
--until - Show commits until date
--author - Filter by author
--grep - Search commit messages
-h, --help - Show detailed help information

Common Use Cases:

# Basic history glog # Standard commit log glog --help # Show help # Formatted views glog --oneline # Compact view glog --graph # Visual branch graph glog --stat # Show file statistics glog --patch # Show full changes # Limited output glog -10 # Last 10 commits glog --since "2 weeks ago" # Recent commits glog --until "yesterday" # Commits until yesterday # Filtered logs glog --author "john@example.com" # Commits by specific author glog --grep "fix" # Commits containing "fix" glog src/app.js # History for specific file

Related Commands: gdiff (compare commits), gcheckout (view old versions), gbranch (branch history) MCP Tool: git_log

`gpop` - Apply Stash

Purpose: Apply previously stashed changes back to the working directory with various application strategies.

Command: gpop [stash-reference] [options]

Parameters:

[stash-reference] - Optional specific stash to apply (defaults to most recent)

Essential Options:

--index - Try to recreate index state
--keep-index - Don't remove from stash list after applying
--quiet - Suppress output
-h, --help - Show detailed help information

Common Use Cases:

# Basic stash operations gpop # Apply most recent stash gpop --help # Show help # Specific stash gpop stash@{2} # Apply specific stash gpop stash@{0} # Apply latest stash explicitly # Advanced options gpop --index # Recreate staged state gpop --keep-index # Keep stash after applying gpop --quiet # Silent application

Related Commands: gstash (create stash), gstatus (check state), gdiff (view changes) MCP Tool: git_stash_pop

`gpull` - Pull Changes

Purpose: Fetch and integrate changes from remote repositories with various strategies and conflict resolution.

Command: gpull [remote] [branch] [options]

Parameters:

[remote] - Optional remote name (defaults to origin)
[branch] - Optional branch name (defaults to current branch)

Essential Options:

--rebase - Rebase instead of merge
--no-rebase - Force merge instead of rebase
--ff-only - Only fast-forward merges
--no-ff - Always create merge commit
--squash - Squash commits from remote
--strategy - Use specific merge strategy
--verify-signatures - Verify GPG signatures
-h, --help - Show detailed help information

Common Use Cases:

# Basic pulling gpull # Pull from origin/current-branch gpull --help # Show help # Specific targets gpull origin main # Pull specific branch gpull upstream develop # Pull from upstream remote # Merge strategies gpull --rebase # Rebase local commits gpull --no-rebase # Force merge gpull --ff-only # Only if fast-forward possible gpull --no-ff # Always create merge commit # Advanced options gpull --squash # Squash remote commits gpull --verify-signatures # Verify commit signatures

Related Commands: gpush (upload changes), gstatus (check conflicts), gmerge (manual merge) MCP Tool: git_pull

`gpush` - Push Changes to Remote

Purpose: Push local commits to remote repository with comprehensive options for branches, tags, and safety.

Command: gpush [remote] [branch] [options]

Parameters:

[remote] - Remote repository name (default: origin)
[branch] - Branch name (default: current branch)

Essential Options:

-u, --set-upstream - Set upstream for branch
--force - Force push (destructive, use with caution)
--force-with-lease - Force push with safety checks
--dry-run - Show what would be pushed
--tags - Push all tags
--follow-tags - Push annotated tags reachable from pushed commits
--all - Push all branches
--delete - Delete remote branch
-v, --verbose - Show verbose output
-q, --quiet - Suppress output
--progress - Show progress information
-h, --help - Show detailed help information

Common Use Cases:

# Basic pushing gpush # Push current branch to origin gpush -u # Set upstream and push gpush --help # Show help # Specific targets gpush origin main # Push main branch to origin gpush upstream feature # Push to upstream remote # Safety options gpush --dry-run # Preview push gpush --force-with-lease # Safe force push gpush --force # Force push (use with caution) # Tags and branches gpush --tags # Push all tags gpush --all # Push all branches gpush --delete origin feature # Delete remote branch

Safety Notes:

--force can overwrite remote history - use with extreme caution
--force-with-lease is safer - checks for remote changes
Use --dry-run to preview changes before pushing

Related Commands: gpull (download changes), gbranch (manage branches), gstatus (check state) MCP Tool: git_push

`gremote` - Remote Management

Purpose: Manage remote repositories with comprehensive operations for adding, removing, and configuring remotes.

Command: gremote [action] [options]

Parameters:

[action] - Optional action (add, remove, rename, show, set-url)

Essential Options:

-v, --verbose - Show remote URLs
--add - Add new remote
--remove - Remove remote
--rename - Rename remote
--set-url - Change remote URL
--get-url - Show remote URL
--show - Show remote details
-h, --help - Show detailed help information

Common Use Cases:

# Basic remote operations gremote # List all remotes gremote -v # List with URLs gremote --help # Show help # Adding remotes gremote --add upstream https://github.com/original/repo.git # Add upstream gremote --add origin git@github.com:user/repo.git # Add origin # Managing remotes gremote --remove old-origin # Remove remote gremote --rename origin new-origin # Rename remote gremote --set-url origin https://github.com/user/new-repo.git # Change URL # Remote information gremote --show origin # Show remote details gremote --get-url upstream # Get remote URL

Related Commands: gclone (clone with remotes), gpush (push to remotes), gpull (pull from remotes) MCP Tool: git_remote

- `greset` - Reset Repository State

Purpose: Reset repository to previous states with various modes and safety options for undoing changes.

Command: greset [mode] [target] [options]

Parameters:

[mode] - Optional reset mode (soft, mixed, hard)
[target] - Optional target commit or reference (defaults to HEAD)

Essential Options:

--soft - Keep working directory and index unchanged
--mixed - Keep working directory, reset index (default)
--hard - Reset working directory and index (dangerous)
--merge - Reset but keep local changes
--keep - Reset but keep local changes (safer than --hard)
--pathspec-from-file - Reset specific files from file list
-h, --help - Show detailed help information

Common Use Cases:

# Basic reset operations greset # Reset index to HEAD (unstage all) greset --help # Show help # Reset modes greset --soft HEAD~1 # Undo last commit, keep changes staged greset --mixed HEAD~1 # Undo last commit, unstage changes greset --hard HEAD~1 # Undo last commit, discard changes # Specific targets greset --hard origin/main # Reset to remote state greset --soft abc123 # Reset to specific commit (keep changes) # File-specific reset greset src/app.js # Unstage specific file greset HEAD~2 -- docs/ # Reset specific directory # Safety options greset --merge HEAD~1 # Reset but preserve local changes greset --keep HEAD~1 # Keep local modifications

Related Commands: gcheckout (switch states), gstash (save changes), glog (find commits) MCP Tool: git_reset

`gstash` - Stash Changes

Purpose: Temporarily save uncommitted changes with various stashing strategies and management options.

Command: gstash [message] [options]

Parameters:

[message] - Optional descriptive message for the stash

Essential Options:

-u, --include-untracked - Include untracked files
-a, --all - Include all files (tracked, untracked, ignored)
--keep-index - Keep staged changes in index
--no-keep-index - Don't keep staged changes (default)
--patch - Interactively select hunks to stash
--pathspec-from-file - Stash files listed in file
-h, --help - Show detailed help information

Common Use Cases:

# Basic stashing gstash # Stash all modified files gstash "Work in progress on login" # Stash with message gstash --help # Show help # Advanced stashing gstash -u # Include untracked files gstash -a # Include all files (even ignored) gstash --keep-index # Keep staged changes # Interactive stashing gstash --patch # Choose what to stash interactively # Stash management gstash list # List all stashes gstash show # Show most recent stash gstash drop # Delete most recent stash gstash clear # Delete all stashes

Related Commands: gpop (apply stash), gstatus (check changes), gcheckout (switch branches) MCP Tool: git_stash

`gstatus` - Repository Status

Purpose: Show comprehensive repository status including staged/unstaged changes, branch info, and working directory state.

Command: gstatus [options]

Essential Options:

-s, --short - Show short format status
-b, --branch - Show branch information
--porcelain - Machine-readable format
--ignored - Show ignored files too
--untracked-files - Control untracked files display
--column - Display in columns
-z - Terminate entries with NUL character
-h, --help - Show detailed help information

Common Use Cases:

# Basic status gstatus # Full status display gstatus --help # Show help # Formatted output gstatus -s # Short status format gstatus -b # Include branch info gstatus --porcelain # Machine-readable format # Extended information gstatus --ignored # Show ignored files gstatus --untracked-files=all # Show all untracked files gstatus --column # Column display format

Related Commands: gadd (stage files), gcommit (commit changes), gdiff (show changes) MCP Tool: git_status

Quick Reference

Daily Workflow Commands

gstatus # Check what changed gadd . # Stage all changes gcommit "message" # Commit with message gpush # Push to remote

Branch Workflow

gbranch # List branches gcheckout -b new # Create new branch gadd . # Stage changes gcommit "update" # Commit changes gpush -u origin new # Push and set upstream gcheckout main # Switch back to main gpull # Update main branch

Emergency Operations

gstash "save work" # Save current work gcheckout main # Switch to main gpull # Get latest changes gcheckout feature # Back to feature gpop # Restore work

Help and Support

Every command includes comprehensive help:

<command> --help # Detailed help for any command <command> -h # Short help format

Related Documentation:

Advanced Operations: See /bin/advanced/README.md for power-user features
MCP Server: Full Git operations via Model Context Protocol
Installation: See main project README for setup

All commands are also available as MCP tools for AI assistants and automation!

Navigation Menu

Search code, repositories, users, issues, pull requests...

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.md

Latest commit

History

README.md

File metadata and controls

Basic Git Operations - CLI Aliases

Overview

Command Details

`gadd` - Stage Files

`gbranch` - Branch Management

- `gcheckout` - Branch Switching

`gclone` - Repository Cloning

`gcommit` - Create Commits

`gdiff` - Show Differences

[NEW] `ginit` - Initialize Repository

`glog` - Commit History

`gpop` - Apply Stash

`gpull` - Pull Changes

`gpush` - Push Changes to Remote

`gremote` - Remote Management

- `greset` - Reset Repository State

`gstash` - Stash Changes

`gstatus` - Repository Status

Quick Reference

Daily Workflow Commands

Branch Workflow

Emergency Operations

Help and Support

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

Basic Git Operations - CLI Aliases

Overview

Command Details

gadd - Stage Files

gbranch - Branch Management

- gcheckout - Branch Switching

gclone - Repository Cloning

gcommit - Create Commits

gdiff - Show Differences

[NEW] ginit - Initialize Repository

glog - Commit History

gpop - Apply Stash

gpull - Pull Changes

gpush - Push Changes to Remote

gremote - Remote Management

- greset - Reset Repository State

gstash - Stash Changes

gstatus - Repository Status

Quick Reference

Daily Workflow Commands

Branch Workflow

Emergency Operations

Help and Support

`gadd` - Stage Files

`gbranch` - Branch Management

- `gcheckout` - Branch Switching

`gclone` - Repository Cloning

`gcommit` - Create Commits

`gdiff` - Show Differences

[NEW] `ginit` - Initialize Repository

`glog` - Commit History

`gpop` - Apply Stash

`gpull` - Pull Changes

`gpush` - Push Changes to Remote

`gremote` - Remote Management

- `greset` - Reset Repository State

`gstash` - Stash Changes

`gstatus` - Repository Status