https://github.com/macklinu/ghui
A TUI built on top of gh
https://github.com/macklinu/ghui
bun cli gh opentui tui
Last synced: 3 months ago
JSON representation
A TUI built on top of gh
- Host: GitHub
- URL: https://github.com/macklinu/ghui
- Owner: macklinu
- Created: 2025-11-10T15:13:40.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-12-11T19:57:45.000Z (6 months ago)
- Last Synced: 2025-12-13T00:35:46.252Z (6 months ago)
- Topics: bun, cli, gh, opentui, tui
- Language: TypeScript
- Homepage:
- Size: 3.31 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ghui
> A TUI built on top of [gh](https://cli.github.com/)
> [!IMPORTANT]
> This is very much a work in progress. Please open an issue if you have feature requests or bug reports.
## Installation
### Mac
```sh
brew install macklinu/tap/ghui
```
If you're looking for Windows or Linux builds, please check the [Releases page](https://github.com/macklinu/ghui/releases) for now and/or help me figure out how to publish the executables to [Linux](https://github.com/macklinu/ghui/issues/2) or [Windows](https://github.com/macklinu/ghui/issues/3) package managers.
## Usage
Everything is built of top of [gh](https://cli.github.com/), so if you're authenticated via `gh auth login`, you should be able to view your GitHub (or GitHub Enterprise) repos with `ghui`.
> [!WARNING]
> I need to work on keybindings for navigation + more commands that get you into PR and issue list/detail views, so the entrypoints and keyboard shortcuts below are likely to change.
### Pull requests
View the PRs for the current working directory repo by typing `ghui prs`. Press `p` while in `ghui` to go to the PRs view at any time.
### Issues
Press `i` while in `ghui` to go to the issues view at any time.
## Development
To install dependencies:
```bash
bun install
```
To run and reload when saving changes:
```bash
bun run --watch src/index.tsx
```