Metadata-Version: 2.4
Name: gman
Version: 0.1.0
Summary: List, manage, and export your GitHub repositories — CLI, TUI, and Excel export.
Keywords: github,cli,tui,repositories,excel,textual
Author: Lance Reinsmith
Author-email: Lance Reinsmith <info@k2rad.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Version Control :: Git
Classifier: Topic :: Utilities
Requires-Dist: openpyxl>=3.1.5
Requires-Dist: requests>=2.34.2
Requires-Dist: rich>=15.0.0
Requires-Dist: textual>=8.2.8
Requires-Python: >=3.10
Project-URL: Homepage, https://github.com/lreinsmith/gman
Project-URL: Repository, https://github.com/lreinsmith/gman
Project-URL: Issues, https://github.com/lreinsmith/gman/issues
Project-URL: Changelog, https://github.com/lreinsmith/gman/blob/main/CHANGELOG.md
Description-Content-Type: text/markdown

<div align="center">

<img src="https://raw.githubusercontent.com/lancereinsmith/github-repo-manager/main/assets/logo.svg" alt="gman logo" width="140" height="140">

# gman

**Your repos. Under investigation.**

List, manage, and export your GitHub repositories from the terminal.

</div>

The G-man for your GitHub account: `gman` puts every repo you own on the record
— list it, archive it, redescribe it, delete it, or export the whole file to
Excel — from a fast CLI or an interactive TUI.

## Features

- **CLI** — `list`, `delete`, `archive`, `describe`, `excel` subcommands
- **TUI** — interactive [Textual](https://textual.textualize.io/) table with
  filter, open-in-browser, archive, edit-description, delete, and Excel export
- **Excel export** — landscape `.xlsx` with banded rows, frozen header, and
  autofilter, sorted by Last Updated descending
- **Works with GitHub Enterprise** via `--api-url` / `GITHUB_API_URL`

## Install

```bash
uv tool install gman        # or: pipx install gman  /  pip install gman
```

## Quick start

```bash
gh auth login                  # or: export GITHUB_TOKEN=ghp_xxx
gman tui                       # interactive UI
gman list --detailed           # or: list, excel, describe, delete, archive
gman-tui                       # shortcut straight into the TUI
```

The token is resolved from `--token`, then `$GITHUB_TOKEN`, then
`gh auth token`. For `delete`, the gh CLI token needs the extra
`delete_repo` scope: `gh auth refresh -h github.com -s delete_repo`.

## Examples

```bash
gman list --json                       # machine-readable output
gman list --include-orgs               # include org & collaborator repos
gman describe owner/repo "New tagline"
gman excel --output ~/Desktop/repos.xlsx
gman --api-url https://ghe.example.com/api/v3 list   # GitHub Enterprise
```

See the [user manual](https://lancereinsmith.github.io/gman/) for full usage and configuration.

## License

[MIT](LICENSE)
