Initial commit: git-scope MVP - TUI for managing git repos

Author: Bharath-code

.gitignore

@@ -0,0 +1,23 @@
+# Binaries
+/dist
+/build
+/bin
+/git-scope
+
+# Logs and temp files
+*.log
+*.tmp
+*.swp
+*~
+
+# Cache
+.git-scope-cache.json
+
+# IDE
+.idea/
+.vscode/
+*.iml
+
+# OS
+.DS_Store
+Thumbs.db

README.md

@@ -0,0 +1,115 @@
+# git-scope
+
+> A fast TUI to see the status of all git repositories on your machine.
+
+![Status](https://img.shields.io/badge/status-MVP-blue)
+![Go Version](https://img.shields.io/badge/go-1.22-00ADD8)
+
+## Overview
+
+**git-scope** is a terminal-based dashboard that helps you manage multiple git repositories. It scans your configured directories, shows you which repos have uncommitted changes, and lets you jump into your editor with a single keystroke.
+
+### Features
+
+- 🔍 **Scan** configured directories for git repos
+- 📊 **Dashboard** showing branch, dirty files, and last commit
+- ⌨️ **Keyboard-driven** navigation
+- 🚀 **Jump** into your editor from the TUI
+- ⚡ **Fast** concurrent scanning with goroutines
+
+## Installation
+
+### From Source
+
+```bash
+go install github.com/bharath/git-scope/cmd/git-scope@latest
+```
+
+Or clone and build:
+
+```bash
+git clone https://github.com/bharath/git-scope.git
+cd git-scope
+go build -o git-scope ./cmd/git-scope
+```
+
+## Usage
+
+### Launch TUI Dashboard
+
+```bash
+git-scope
+# or
+git-scope tui
+```
+
+### Scan and Output JSON
+
+```bash
+git-scope scan
+```
+
+### Configuration
+
+Create a config file at `~/.config/git-scope/config.yml`:
+
+```yaml
+# Directories to scan for git repos
+roots:
+  - ~/code
+  - ~/projects
+  - ~/work
+
+# Directories to ignore
+ignore:
+  - node_modules
+  - .next
+  - dist
+  - build
+  - target
+  - .venv
+  - vendor
+
+# Editor to open repos (default: code)
+editor: code
+```
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `↑/↓` or `j/k` | Navigate repos |
+| `Enter` | Open repo in editor |
+| `r` | Rescan directories |
+| `q` | Quit |
+
+## Dashboard Columns
+
+| Column | Description |
+|--------|-------------|
+| Repo | Repository name |
+| Path | File path (truncated) |
+| Branch | Current branch |
+| Stg | Staged file count |
+| Unst | Unstaged file count |
+| Untrk | Untracked file count |
+| Last Commit | Last commit timestamp |
+
+## Roadmap
+
+- [ ] Caching for faster startup
+- [ ] Fuzzy search filter
+- [ ] Sort by different columns
+- [ ] Quick actions (pull, push)
+- [ ] Background file watcher
+
+## Tech Stack
+
+- **Go** - Fast, compiled binary
+- **Bubbletea** - TUI framework
+- **Lipgloss** - Terminal styling
+- **Bubbles** - TUI components
+
+## License
+
+MIT

cmd/git-scope/main.go

@@ -0,0 +1,76 @@
+package main
+
+import (
+	"flag"
+	"fmt"
+	"log"
+	"os"
+
+	"github.com/bharath/git-scope/internal/config"
+	"github.com/bharath/git-scope/internal/scan"
+	"github.com/bharath/git-scope/internal/tui"
+)
+
+const version = "0.1.0"
+
+func usage() {
+	fmt.Fprintf(os.Stderr, `git-scope v%s — A fast TUI to see the status of all git repositories
+
+Usage:
+  git-scope [command]
+
+Commands:
+  (default)   Launch TUI dashboard
+  scan        Scan configured roots and print repos (JSON)
+  tui         Launch TUI dashboard (same as default)
+  help        Show this help
+
+Flags:
+`, version)
+	flag.PrintDefaults()
+}
+
+func main() {
+	flag.Usage = usage
+	configPath := flag.String("config", config.DefaultConfigPath(), "Path to config file")
+	flag.Parse()
+
+	// Default command is "tui" if no args provided
+	cmd := "tui"
+	if flag.NArg() >= 1 {
+		cmd = flag.Arg(0)
+	}
+
+	// Handle help early
+	if cmd == "help" || cmd == "-h" || cmd == "--help" {
+		usage()
+		return
+	}
+
+	// Load configuration
+	cfg, err := config.Load(*configPath)
+	if err != nil {
+		log.Fatalf("failed to load config: %v", err)
+	}
+
+	switch cmd {
+	case "scan":
+		repos, err := scan.ScanRoots(cfg.Roots, cfg.Ignore)
+		if err != nil {
+			log.Fatalf("scan error: %v", err)
+		}
+		if err := scan.PrintJSON(os.Stdout, repos); err != nil {
+			log.Fatalf("print error: %v", err)
+		}
+
+	case "tui", "":
+		if err := tui.Run(cfg); err != nil {
+			log.Fatalf("tui error: %v", err)
+		}
+
+	default:
+		fmt.Fprintf(os.Stderr, "unknown command: %s\n\n", cmd)
+		usage()
+		os.Exit(1)
+	}
+}

configs/config.example.yml

@@ -0,0 +1,21 @@
+# Git-Scope Configuration
+# Copy this file to ~/.config/git-scope/config.yml
+
+# Root directories to scan for git repositories
+roots:
+  - ~/code
+  - ~/projects
+
+# Directories to ignore during scanning
+ignore:
+  - node_modules
+  - .next
+  - dist
+  - build
+  - target
+  - .venv
+  - vendor
+
+# Editor to open repos in (default: code)
+# Options: code, idea, nvim, vim, etc.
+editor: code