Git Status Check Script

check_git_status.sh is a Bash script designed to verify the status of multiple Git repositories within a workspace. It helps identify untracked files, unstaged changes, uncommitted commits, and branch differences with the remote repository.

---

Features

The script analyzes each Git repository in a workspace and identifies:

1. Untracked files:

   • Files in the working directory that haven’t been added to Git (git add not run).

2. Staged but uncommitted files:

   • Files that were added with git add but not yet committed.

3. Unstaged changes:

   • Files with local modifications that haven’t been added to the staging area.

4. Unpushed commits:

   • Local commits that haven’t been pushed to the remote repository.

5. Branches not in sync with the remote (only when using the fetch option):

   • Detects if the local branch is ahead of or behind the remote branch.

---

Usage

The script supports the following modes:

1. Default Mode: Checks repository status without updating remote references.

   check_git_status

2. Fetch Mode: Runs git fetch for each repository before performing checks.

   check_git_status fetch

3. Debug Mode: Outputs detailed information during execution, useful for troubleshooting.

   check_git_status debug

4. Fetch + Debug Mode: Combines fetch and debug modes, updating remote references and providing detailed output.

   check_git_status fetch-debug

5. Specifying Directories: You can also pass specific directories as arguments to limit the scope of the search for Git repositories. The script will recursively explore those directories for any repositories. If no directories are specified, it defaults to searching the current directory.

   check_git_status /path/to/workspace1 /path/to/workspace2

   or

   check_git_status fetch /path/to/workspace1 /path/to/workspace2

---

Output

Summary Table

The script generates a summary table listing the repositories with detected changes. Example:

Summary Table

The script generates a summary table listing the repositories with detected changes. Example:

Package Name	Status	Behind Origin	Repository Path
example_repo	Modified but not added/committed	No	/path/to/workspace/example_repo
another_repo	Branch not in sync with remote	Yes	/path/to/workspace/another_repo

• Status: Indicates the repository's local changes.
• Behind Origin: Shows whether the local branch is behind the remote (only visible if fetch is used).
• Repository Path: Displays the full directory path of the repository.

When Everything is Clean

If no issues are detected, the script outputs:

All repositories are up-to-date.

---

Installation

Steps to Make the Script Accessible Globally

1. Copy the scripts to a directory in your PATH:

   • To see directories in your PATH, run:

     echo $PATH

   • Common directories include /usr/local/bin. Copy the script there:

     sudo cp check_git_status.sh /usr/local/bin/

   • Copy the autocompletion script:

     sudo cp check_git_status /etc/bash_completion.d/

2. Grant Execute Permissions:

   sudo chmod +x /usr/local/bin/check_git_status.sh
   sudo chmod +x /etc/bash_completion.d/check_git_status

3. Verify Installation: You should now be able to run the script from any directory:

   check_git_status

---

Requirements

• Git: Ensure Git is installed on your system.
• Bash: The script is compatible with Bash.

---

Contributing

If you have suggestions to improve the script or encounter any issues, feel free to submit a pull request or report a problem.

---

Notes

• Without the fetch option, the script does not detect changes in branches that are not synced with the remote.
• If you pass directories as arguments, the script will search those specific directories and their subdirectories for Git repositories. If no directories are passed, the script will search the current directory by default.

---