muster
TUI for managing your issues across the land of GitHub.


What it does
muster is a keyboard-driven GitHub issue client. It starts with issues involving your account, and lets you open individual repositories in tabs when you need to focus on one project.
- Browse issues involving you across repositories
- Add owned repositories or any accessible
owner/repoas tabs - Switch between open, closed, and all issues
- Search by title, author, issue number, or label
- Read issue descriptions, labels, metadata, and comments
- Write comments without leaving the TUI
- Create issues with a description and labels
- Create missing labels while creating an issue
- Close and reopen issues
- Navigate entirely from the keyboard, with an expanded reading view
GitHub Access
muster uses the GitHub CLI for authentication so it does not manage or store GitHub tokens directly.
Requirements:
- Install
ghfrom https://cli.github.com/. - Authenticate with
gh auth login --hostname github.com --web --scopes repo,read:org.
This project is still early, so expect bugs and inconsistencies.
Install the prebuilt muster command from npm:
npm install --global @kaiwlsn/muster
muster
Prebuilt binaries support macOS and glibc-based Linux on arm64 and x64. Bun is embedded in the binary and is not required at runtime. The npm launcher requires Node.js 20 or newer.
For development from this checkout, install Bun and run bun run start. You can also use npm link; the development launcher falls back to the Bun source entrypoint.
License and Source
muster is licensed under GPL-3.0-only. Corresponding source for each published binary is available from the matching version tag in this repository.
Acknowledgments
The GitHub CLI authentication approach is based on Kit Langton's ghui GitHub authentication module.
Local Reference Repositories
This project vendors external source repositories under repos/ using squashed git subtrees so coding agents can inspect real implementation and usage patterns locally.
repos/effect: Effect source and tests.repos/opentui: OpenTUI source, docs, and examples.
These directories are reference material. Application code should depend on published packages, not import from repos/.
Updating References
git subtree pull --prefix=repos/effect https://github.com/Effect-TS/effect.git main --squash
git subtree pull --prefix=repos/opentui https://github.com/anomalyco/opentui.git main --squash