Metadata-Version: 2.4
Name: gag-repo-viewer
Version: 0.2.23
Summary: Git Branch Detector GUI Tool
Project-URL: Homepage, https://x.com/TakashiSasaki
Author: Takashi Sasaki
Requires-Python: >=3.8
Requires-Dist: pipx>=1.7.1
Description-Content-Type: text/markdown

# gag-repo-viewer (Git Related Branch Detector)

**Author:** Takashi Sasaki ([@TakashiSasaki](https://x.com/TakashiSasaki))

This tool helps visualize the relationship between the current branch and other branches, including remote tracking branches and reflog entries. It is part of the [gag](https://pypi.org/project/gag/) tool suite.

## Project Philosophy: The Viewer's Promise
This application is designed as a **read-only viewer**. Its core mission is to provide clarity and insight into Git repositories without ever altering them. 

- **No Modifications**: The GUI does not and will not provide features to commit, branch, merge, or otherwise modify the repository state.
- **Safe Exploration**: Users can explore complex branch relationships and submodule states with total confidence that their repository remains untouched.
- **Separated Concerns**: State-changing operations are left to the Git CLI or primary clients, ensuring this tool remains a safe, passive observer.

## Quick Run

The easiest way to run the latest version is via **uvx** or **pipx** (no installation required):

### 1. Using uvx (Fastest)

```bash
uvx gag-repo-viewer
```

### 2. Using pipx

```bash
pipx run gag-repo-viewer
```

### 3. Installation

Or install it permanently to your environment:

```bash
pip install gag-repo-viewer
```

## Features

- Visualize relationships (Ancestor, Tip, Diverged, Independent).
- Support for Reflog entries and Remote tracking branches.
- Rich GUI with filters and real-time status.
