Skip to content

gws logo

git-workspace

CI Snyk Security Release License

A lightweight, cross-platform CLI tool for discovering, organizing, and navigating git repositories on your local system.

Features

  • Subcommand-Based CLI: Clean command structure with list, init, add, refresh, tag, user, and parent subcommands
  • Compact Default View: Multi-column repository names at a glance, with verbose modes for detailed tables
  • Repository Discovery: Automatically find all git repositories in a directory tree
  • Automatic Classification: Detect repository type (GitHub, GitLab, Azure DevOps, Bitbucket) from remote URLs
  • Dual-Purpose Filtering: Lowercase flags filter results; uppercase flags show columns with optional filtering
  • Git Status Integration: View branch, clean/dirty state, and ahead/behind indicators with color output
  • Smart Caching: Fast status display with configurable cache and concurrent workers (--workers)
  • Custom Tagging: Organize repositories with gws tag add / gws tag remove
  • Advanced Filtering: Search and filter repositories by type, tags, name, path, status, user, or remote URL
  • User Profile Management: Manage git user profiles across repositories with gws user
  • Repository Navigation: Jump to any repository instantly with gws <repo-name>
  • Parent Navigation: Navigate to a repository's parent directory with gws parent or gws -p
  • Remote URL Display: View formatted or raw remote URLs with --show-remote / --show-remote-raw
  • External Repo Symlinks: Automatically creates workspace symlinks for repositories outside the workspace root
  • Workspace Management: Track and organize repositories in a centralized configuration
  • Cross-Platform: Works on Linux, macOS, and Windows
  • Lightweight: Single binary with no external dependencies

Documentation

  • Getting Started — Install git-workspace and set up your workspace for the first time
  • Commands:
    • Core Commands — Listing, initializing, adding, refreshing, and navigating repositories
    • User Management — Managing git user profiles across repositories
    • Tagging — Organizing repositories with custom tags
    • Legacy Flags — Deprecated flag-to-subcommand migration reference
  • Shell Integration — Set up the gws shell function and workspace navigation
  • Configuration — Config file location, structure, and field reference