GitUnstuck turns confusing Git output into clear, risk-aware recovery steps. Paste a status or error, choose what went wrong, and get commands you can understand before you run them.
No installation. No account. No terminal data leaves your browser.
GitUnstuck helps answer the questions that matter when a repository goes wrong:
- Is my work safe? Every diagnosis shows the risk before suggesting a command.
- What happened? Plain-English explanations replace cryptic Git terminology.
- What should I run? Copyable steps take you forward, back out safely, or create a rescue point.
- Does my hosting provider change the fix? Dedicated guidance covers GitHub, GitLab, and Bitbucket.
Paste output from git status, git status -sb, or a Git error. The analyzer recognizes common failure states, strips terminal formatting, handles Windows line endings, and immediately explains what it found.
It can identify:
- Detached HEAD and branch divergence
- Merge conflicts and paused rebases
- Authentication and protected-branch failures
- GitHub GH013 and other secret-scan blocks
- Untracked sensitive files such as
.envandid_rsa - Clean repositories where no recovery is needed
Everything runs locally in the current browser tab. Repository paths, branch names, errors, and pasted text are never uploaded.
Tell GitUnstuck where the unwanted change lives and receive the appropriate recovery path:
| Situation | Guided approach |
|---|---|
| Changed but not staged | Restore or preserve the file with a clear data-loss warning |
| Staged by mistake | Unstage it while keeping the edits |
| Committed locally | Rewind the commit while preserving the work |
| Already pushed | Create a team-safe revert |
| Commit or branch appears lost | Recover it from the reflog |
| Unsure what to do | Create a backup branch before changing history |
Switch between GitHub, GitLab, and Bitbucket for provider-specific fixes covering:
- Rejected pushes and protected branches
- Tokens, app passwords, and cached credentials
- Secret-scanning and push-protection blocks
- Fork synchronization and upstream remotes
- Feature-branch and pull/merge-request workflows
Interactive diagrams turn Git’s internal model into something you can inspect:
- Follow a file through the working directory, staging area, local repository, and remote forge
- Explore commits, branches, HEAD, and merges on a visual timeline
- Inspect command effects before choosing a recovery step
- Open deeper explanations of object storage, commit graphs, and three-way merges when you want the theory
- Guided Essentials uses plain language, practical analogies, and focused daily workflows.
- Developer Hub opens the complete engineering reference for rebase, reflog, worktree, bisect, tags, cherry-pick, force-with-lease, branch surgery, and
.git/internals.
Both modes include dark and light themes, keyboard navigation, reduced-motion support, and screen-reader announcements.
Jump directly to the right tool:
- Undo a Git mistake
- Analyze terminal output
- Recover a lost commit with reflog
- Fix GitHub problems
- Fix GitLab problems
- Fix Bitbucket problems
- Understand merge conflicts
- Understand detached HEAD
These links can be shared in team chat, documentation, and support replies.
GitUnstuck is a dependency-free, client-side application built with vanilla HTML, CSS, and JavaScript. It has no build step and sends no pasted terminal content to a server. The interface is designed for WCAG AA contrast and supports keyboard and screen-reader use.
Clone the repository and open index.html in a modern browser. No package installation or build command is required.
Run the automated regression suite with:
node tests/test-analyzer.jsThe suite contains 155 assertions across 13 test groups covering diagnostics, normalization, forge guidance, navigation, accessibility, branding, experience modes, and the visual data-flow tools.
See CHANGELOG.md for release history and detailed change notes.
GitUnstuck is free, private, client-side, and ad-free. If it rescued a branch, clarified a workflow, or saved your team time, you can support its continued development:
MIT License. Free for developers, students, and teams worldwide.