gh-claude 0.3.1

A modern multi-repository GitHub TUI with Claude Code integration

gh-claude

A modern, keyboard-first TUI for managing GitHub issues and pull requests across multiple repositories. It uses Textual for the interface, GitHub CLI for data, and Claude Code for issue drafting and analysis.

License: MIT

PyPI: gh-claude
Repository: masaaaaa725/ghc

Requirements

• Python 3.13+
• uv or pip
• GitHub CLI (gh auth login)
• Claude Code (claude)
• Git

Install

pip install gh-claude
# or
uv tool install gh-claude

Update an existing uv tool install:

uv tool upgrade gh-claude

Publishing

Every push to main runs .github/workflows/publish.yml, which bumps the patch version in pyproject.toml, publishes that version to PyPI, and commits the bump back to main (with [skip ci] to avoid a loop).

One-time setup on PyPI (Trusted Publishing):

1. Open PyPI publishing settings for gh-claude
2. Add a GitHub publisher:
   • Owner: masaaaaa725
   • Repository: ghc
   • Workflow: publish.yml
   • Environment: pypi
3. In GitHub, create an Environment named pypi (Settings → Environments)

After that, merges to main publish automatically. Users can then run uv tool upgrade gh-claude.

Run

gh-claude
# alias
ghc

From a local checkout:

uv sync
uv run gh-claude

The app detects the GitHub repository in the current directory. Press r or Ctrl+P to switch to any repository returned by gh repo list.

Keyboard shortcuts

• ↑ / ↓: move the selection in the Issues or Pull Requests list
• ← / →: switch between the Issues and Pull Requests tabs
• f: cycle the status filter (OPEN → CLOSED → ALL for Issues; includes MERGED / DRAFT for PRs)
• r / Ctrl+P: searchable repository picker (↑/↓ to move, Enter to select, Esc to cancel)
• c: turn rough notes into a reviewed GitHub issue with Claude
• s: summarize the selected issue or pull request with Claude
• o: check out the selected pull request as a local branch
• v: review the selected pull request diff with Claude
• a: draft, preview, and post an AI-polished comment
• Ctrl+E: create an Issue branch and let Claude implement the selected Issue
• i / p: switch to Issues / Pull Requests
• Ctrl+R / F5: refresh Issues and Pull Requests for the current repository
• Ctrl+C: quit

Project layout

.
├── pyproject.toml
├── uv.lock
├── src/                # Import package `ghc` (PyPI name: `gh-claude`)
│   ├── __init__.py
│   ├── __main__.py
│   ├── app.py          # Main Textual app and interactions
│   ├── app.tcss        # Dark UI theme
│   ├── clients.py      # Async gh / claude / git wrappers
│   ├── models.py       # Domain models
│   └── screens.py      # Repository and issue workflow modals
└── tests/
    ├── test_app.py
    ├── test_clients.py
    ├── test_models.py
    └── test_screens.py

All external commands are executed without a shell via asyncio.create_subprocess_exec. GitHub read operations request JSON explicitly; commands such as gh pr diff, gh pr checkout, gh issue create, and gh issue comment are exceptions because those GitHub CLI commands do not support --json.

Ctrl+E is intentionally limited to the repository currently checked out on disk. After confirmation, it creates issue-<number>-<slug> with git checkout -b, then runs Claude Code in print mode. Claude is instructed not to commit, push, or modify unrelated files; always review the working tree after it finishes.

Test

uv run pytest