git-scope

A fast TUI dashboard to view the git status of all your repositories in one place. > Stop the cd → git status loop.

⚡ Installation

Get started in seconds.

Homebrew (macOS/Linux)

brew tap Bharath-code/tap && brew install git-scope

Update

brew upgrade git-scope

Universal Installer (macOS/Linux)

curl -sSL https://raw.githubusercontent.com/Bharath-code/git-scope/main/scripts/install.sh | sh

From Source (Windows)

go install github.com/Bharath-code/git-scope/cmd/git-scope@latest

If you find this useful, please consider giving it a ⭐ star to help others find it!

🚀 Usage

Simply run it in any directory containing your projects:

git-scope

Commands

git-scope              # Launch TUI dashboard
git-scope init         # Create config file interactively
git-scope scan         # Scan and print repos (JSON)
git-scope scan-all     # Full system scan from home directory
git-scope issue        # Open GitHub issues page in browser
git-scope -h           # Show help

By default, it recursively scans the current directory. You can configure permanent root paths later.

🆚 git-scope vs. lazygit

• git-scope is for your workspace (bird's-eye view).
• lazygit is for a specific repository (deep dive).

✨ Features

• 📁 Workspace Switch — Switch root directories without quitting (w). Supports ~, relative paths, and symlinks.
• 🔍 Fuzzy Search — Find any repo by name, path, or branch (/).
• 🛡️ Dirty Filter — Instantly show only repos with uncommitted changes (f).
• 📄 Pagination — Navigate large repo lists with page-by-page browsing ([ / ]). Shows 15 repos per page with a dynamic page indicator.
• 🚀 Editor Jump — Open the selected repo in VSCode, Neovim, Vim, or Helix (Enter).
• ⚡ Blazing Fast — JSON caching ensures ~10ms launch time even with 50+ repos.
• 📊 Dashboard Stats — See branch name, staged/unstaged counts, and last commit time.
• 🌿 Contribution Graph — GitHub-style local heatmap for your activity (g).
• 💾 Disk Usage — Visualize .git vs node_modules size (d).
• ⏰ Timeline — View recent activity across all projects (t).
• 🔗 Symlink Support — Symlinked directories resolve transparently (great for Codespaces/devcontainers).

⌨️ Keyboard Shortcuts

⚙️ Configuration

Edit workspace location and code editor of your choice in ~/.config/git-scope/config.yml:

# ~/.config/git-scope/config.yml
roots:
  - ~/code
  - ~/work/microservices
  - ~/personal/experiments

ignore:
  - node_modules
  - .venv
  - dist

editor: code # options: code,nvim,lazygit,vim,cursor

💡 Why I Built This

I work across dozens of small repositories—microservices, dotfiles, and side projects. I kept forgetting which repos had uncommitted changes or unpushed commits.

My mornings used to look like this:

cd repo-1 && git status
cd ../repo-2 && git status
# ... repeat for 20 repos

I built git-scope to solve the "Multi-Repo Blindness" problem. It gives me a single screen to see what is dirty, what is ahead/behind, and where I left off yesterday.

🗺️ Roadmap

• [x] In-app workspace switching with Tab completion
• [x] Symlink resolution for devcontainers/Codespaces
• [ ] Background file watcher (real-time updates)
• [ ] Quick actions (bulk pull/fetch)
• [ ] Repo grouping (Service / Team / Stack)
• [ ] Custom team dashboards

📄 License

MIT © Bharath-code

🙏 Acknowledgements

Built with these amazing open-source projects:

• Bubble Tea — The TUI framework
• Lip Gloss — Style definitions
• Bubbles — TUI components (table, spinner, text input)

⭐ Star History

👥 Contributors

Made with contrib.rocks.