Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🔍 Git Uncommitted Scanner

Python Typer Textual PyPI version License

A lightning-fast, cross-platform utility that recursively deep-scans directories to instantly find Git repositories with uncommitted changes.


⚡ Why git-uncommitted-scanner?

Tired of discovering forgotten, uncommitted work in scattered repositories months later? git-uncommitted-scanner hunts down pending changes across your entire filesystem with asynchronous speed, presenting them in either a clean CLI table or a high-tech interactive TUI.


📦 Installation

Install globally via pip (or pipx for isolated environments):

pip install git-uncommitted-scanner

🚀 Usage

The tool provides a single command scanrepos that works in two modes: standard CLI and interactive TUI.

Standard CLI Mode

Run a blazing-fast background scan that outputs a clean, readable table of repositories needing your attention.

# Scan the current directory
scanrepos

# Scan a specific path
scanrepos /path/to/your/projects

Interactive TUI Mode

Launch the high-tech Neon-Cyan Terminal User Interface for an interactive experience. Navigate repositories with your keyboard and spawn a native terminal to instantly handle changes.

# Launch TUI in the current directory
scanrepos -i

# Launch TUI for a specific path
scanrepos -i /path/to/your/projects

✨ Key Features

  • Asynchronous Deep-Scanning: Rapidly traverses deep folder structures in the background without blocking the UI.
  • Lightning-Fast CLI Output: Instantly summarizes findings in a clean, easily readable terminal table.
  • High-Tech Neon-Cyan TUI: A beautiful, interactive textual interface accessible via a simple -i flag.
  • Keyboard Navigation: Full keyboard support in the TUI for seamless, mouse-free workflow.
  • OS-Aware Terminal Spawning: Select a repository in the TUI and instantly spawn a native terminal (Windows, macOS, or Linux) running git status right in that directory.
  • Cross-Platform: Built to work flawlessly across Windows, macOS, and Linux environments.

Built with Python, Typer, and Textual.


Built with ❤️ by RootDeveloperDS

About

A lightning-fast, cross-platform utility that recursively deep-scans directories to instantly find Git repositories with uncommitted changes.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages