Zinc Oxide

Documentation

A Rust CLI tool that recursively checks for git projects and reports their statuses.

Zinc Oxide scans directories to find git repositories and displays their current status, showing which repositories have uncommitted changes. It's useful for managing multiple projects and ensuring all your repositories are in a clean state.

Installation

https://github.com/mozart409/zinc_oxide

Usage

Basic usage

zinc_oxide

Searches the current directory recursively for git repositories and reports their status.

Specify a path

          zinc_oxide --path /path/to/search

          zinc_oxide -p ~/code/

Show individual files

zinc_oxide -f

Shows the specific files that have uncommitted changes.

Show empty repositories

zinc_oxide -e

Includes repositories that have no uncommitted changes in the output.

Combine options

zinc_oxide --path ~/code -f -e

Options

-h, --help: Print help message
-p, --path <p>: Check this absolute path (defaults to current directory)
-f, --files: Show individual files with uncommitted changes
-e, --empty: Show empty repositories (those with no uncommitted changes)

Examples

          # Search current directory for git repos with changes

          zinc_oxide

          # Search a specific directory and show changed files

          zinc_oxide --path ~/dev -f

          # Show all repositories including clean ones

          zinc_oxide -e

Features

Recursive directory scanning for git repositories
Status reporting for uncommitted changes
File-level detail when requested
Hidden directory filtering
Bare repository detection and exclusion
Comprehensive test coverage