Git-Scope User Guide

Source: Dev.to

Introduction

Git‑Scope is a terminal dashboard for your local Git repositories.
Stop cd‑ing into folders to check status. Scan your projects and see a real‑time dashboard of your entire workload.

Installation

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

or, using Go:

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

Commands

Flags

• -config: path to config file (default: ~/.config/git-scope/config.yml)

Dashboard Overview

When you run git-scope, each repository entry shows:

• Status: ● Dirty (uncommitted/unpushed) or ✓ Clean
• Repository: Project folder name
• Branch: Active branch (e.g., main)
• Staged: Files ready to commit
• Modified: Changed files
• Untracked: New files
• Last Commit: Time since the last commit

Git‑Scope is keyboard‑first.

Keybindings

Actions

Usage Tips

• Git‑Scope searches for Git repositories recursively in the current directory.
• Run it from ~/projects (or a similar top‑level folder) for best results.
• node_modules directories are ignored automatically.
• Results are cached for speed (typically <10 ms). Press r to refresh the cache if needed.
• Check the Sync column for ↓ (behind origin).
• Press f to view only dirty repositories, then Enter to open and fix them.

Getting Started

• Star the project on GitHub.
• Visit the official website for more information.