DEV Community

Cover image for How to Tame Your Multi-Repo Chaos with the Terminal
Bharathkumar
Bharathkumar

Posted on

How to Tame Your Multi-Repo Chaos with the Terminal

#go #opensource #git #cli

As a full-stack developer or SRE, you likely live in a world of microservices and polyrepos.

You have 10, 20, or maybe 50+ repositories cloned locally.

  • apps/frontend
  • apps/backend
  • libs/ui-kit
  • infrastructure/terraform
  • ...and that one side-project you forgot about.

The Problem: "Context Fatigue" 🛑

Every morning, the ritual is the same. navigate to each folder, checking if you forgot to push changes or if you're behind origin/main.

cd apps/frontend
git status
# nothing to commit
cd ../../libs/ui-kit
git status
# ...
Enter fullscreen mode Exit fullscreen mode

This manual context switching is a productivity killer. It pulls you out of your flow state before you even write a single line of code.

Existing GUIs (like GitHub Desktop or Sourcetree) are often too slow or bloated due to Electron. lazygit is amazing, but it's designed for focusing on one repository at a time, not managing fifty.

The Solution: A "God Mode" Dashboard for Git ⚡️

I needed a tool that was:

  1. Blazing Fast: Instant startup (written in Go).
  2. Terminal First: I don't want to leave my CLI.
  3. Multi-Repo: Shows me the state of all my projects in one view.

So, I built Git-Scope.

Git-Scope Demo

Key Features

  • Recursive Discovery: Automatically finds git repos in your ~/projects folder.
  • "Dirty First" Sorting: Instantly bubbles up repos with uncommitted changes so you never lose work.
  • Fuzzy Search: Type / to jump to any project by name.

Who is this for? (ICP & Use Cases)

We built this for the Polyrepo Power User—specifically:

1. The Microservices Backend Engineer 🏗️

Pain: You are working on a feature that spans 5 services (auth, payments, core, etc.). You edited code in 3 of them but forgot which ones.
Solution: Open Git-Scope. The "Dirty" status bubbles all 3 modified repos to the top. You commit and push them in seconds, ensuring your PRs stay in sync.

2. The SRE / DevOps Engineer 🛠️

Pain: You manage dozens of Terraform modules or Ansible roles. You need to check if your local copies are behind origin/main before running a plan.
Solution: One glance at the dashboard shows you exactly which infrastructure repos are out of date (↓ 2 commits behind). You can pull updates without cd-ing into each directory.

3. The Open Source Maintainer 🐙

Pain: You maintain 10+ libraries. You have random stashes and unpushed experimental branches scattered everywhere.
Solution: Use the Fuzzy Search (/) to instantly jump between libraries to review PRs locally. Use the "Clean" filter to find "abandoned" experiments you forgot to delete or push.

How to Install

If you are on macOS or Linux, you can install it via Homebrew:

brew tap Bharath-code/tap
brew install git-scope
Enter fullscreen mode Exit fullscreen mode

Or install directly with Go:

go install github.com/Bharath-code/git-scope/cmd/git-scope@latest
Enter fullscreen mode Exit fullscreen mode

Why I Built This?

I wanted a tool that respects the "Unix Philosophy": do one thing and do it well.

Git-Scope doesn't try to replace git or lazygit. It complements them. It's the high-level radar functionality that was missing from my workflow. It helps me stay in the flow and manage my local git universe without the friction.

Check it out on GitHub and let me know what you think!

👉 GitHub Repository
👉 Website

Top comments (0)