Git Panic CLI

Big friendly buttons for common Git disasters - Terminal Edition

---

Overview

Git Panic CLI brings the power of the Git Panic VS Code extension to your terminal. Fix Git disasters with interactive prompts instead of memorizing arcane commands.

$ gitpanic

  Git Panic - What went wrong?

  ── Commit Operations ──
  ❯ Undo Last Commit(s)          git reset --soft/mixed/hard HEAD~N
    Fix Commit Message           git commit --amend -m "..."
    Add Files to Last Commit     git add && git commit --amend
    Squash Commits               git reset --soft && git commit
  ── Branch Operations ──
    Recover Deleted Branch       git reflog && git checkout -b
  ── Staging Operations ──
    Unstage Files                git reset HEAD <file>
    Discard Local Changes        git checkout -- <file>
    Clean Untracked Files        git clean -fd
  ── Recovery Operations ──
    Recover File from History    git checkout <commit> -- <file>
    Stash Operations             git stash push/pop/apply

---

Installation

npm (Recommended)

npm install -g gitpanic-cli

npx (No Install)

npx gitpanic-cli

Homebrew (macOS/Linux)

brew tap SinfulSoul007/gitpanic
brew install gitpanic

---

Usage

Interactive Menu (Default)

Simply run gitpanic to open the interactive menu:

gitpanic

Use arrow keys to navigate, Enter to select.

Direct Commands

Skip the menu and run commands directly:

# Undo commits
gitpanic undo          # Undo last commit
gitpanic undo 3        # Undo last 3 commits

# Fix commit message
gitpanic fix-message   # Interactive prompt
gitpanic fix-message "New message"

# Add files to last commit
gitpanic add-files     # Select files to add

# Squash commits
gitpanic squash        # Interactive prompt
gitpanic squash 3      # Squash last 3 commits

# Branch operations
gitpanic recover-branch    # Recover deleted branch

# Staging operations
gitpanic unstage       # Unstage files
gitpanic discard       # Discard changes
gitpanic clean         # Clean untracked files

# Recovery operations
gitpanic abort         # Abort merge/rebase/cherry-pick
gitpanic recover-file  # Recover file from history
gitpanic stash         # Stash operations menu

# Status and history
gitpanic status        # Show repo status with issues
gitpanic history       # Show GitPanic action history
gitpanic undo-action   # Undo last GitPanic action

---

Commands Reference

Command	Alias	Description
gitpanic	gitpanic menu	Open interactive menu
gitpanic undo [count]	-	Undo last N commits
gitpanic fix-message [msg]	amend-message	Fix last commit message
gitpanic add-files	amend	Add files to last commit
gitpanic squash [count]	-	Squash N commits into one
gitpanic recover-branch	rb	Recover deleted branch
gitpanic unstage	-	Unstage files
gitpanic discard	-	Discard local changes
gitpanic clean	-	Clean untracked files
gitpanic abort	-	Abort ongoing operation
gitpanic recover-file	rf	Recover file from history
gitpanic stash	-	Stash operations
gitpanic status	s	Show repo status
gitpanic history	h	Show action history
gitpanic undo-action	-	Undo last GitPanic action

---

Features

Interactive Prompts

Every command guides you through the process with clear prompts:

$ gitpanic undo

📋 Recent commits:

1. abc1234 Add new feature (John)
2. def5678 Fix bug (John)
3. ghi9012 Initial commit (John)

? How many commits do you want to undo? 1
? How do you want to handle the changes?
  ❯ Keep changes staged (soft reset)
    Keep changes unstaged (mixed reset)
    Discard all changes (hard reset)

Safety Checks

Git Panic warns you before dangerous operations:

⚠️  Warnings:
  • Commit "Add new feature" has been pushed. Undoing will require force push.

? Continue anyway? (y/N)

Action History

Every action is recorded and can be undone:

$ gitpanic history

📜 GitPanic Action History

12345abc Undo 1 commit(s) with soft reset  1/19/2025, 3:30 PM [undoable]
  abc1234 → def5678

$ gitpanic undo-action
✓ Undid "Undo 1 commit(s) with soft reset"

Educational Tooltips

Every menu item shows the equivalent Git command:

  Undo Last Commit(s)          git reset --soft/mixed/hard HEAD~N
  Fix Commit Message           git commit --amend -m "..."

---

Configuration

Git Panic stores configuration in ~/.gitpanic/config.json:

{
  "confirmDangerousActions": true,
  "maxActionHistory": 50,
  "verbose": false
}

Action history is stored in ~/.gitpanic/history.json.

---

Comparison with VS Code Extension

Feature	CLI	VS Code Extension
All 16 recovery operations	✓	✓
Interactive prompts	✓	✓
Action history/undo	✓	✓
Educational tooltips	✓	✓
Safety confirmations	✓	✓
Diff preview	-	✓
Status bar integration	-	✓

---

Related Projects

• gitpanic - VS Code extension
• homebrew-gitpanic - Homebrew formula

---

Contributing

# Clone the repository
git clone https://github.com/SinfulSoul007/gitpanic-cli.git
cd gitpanic-cli

# Install dependencies
npm install

# Build
npm run build

# Test locally
npm link
gitpanic --version

---

License

MIT License - see LICENSE for details.

---

Stop panicking. Start recovering.