better-github
v0.0.1
Published
An opinionated, local-first GitHub dashboard, powered by your gh CLI. Launches with npx better-github.
Downloads
142
Maintainers
Readme
better-github
An opinionated, local-first GitHub dashboard, powered by your local gh CLI.
Status: early, active development. APIs, screens and config are all expected to change. Not yet published to npm.
Why
The GitHub web UI does a lot but is not optimized for the workflows individual engineers actually run day to day. better-github is an opinionated dashboard that talks to GitHub through your already-authenticated gh CLI, so:
- nothing leaves your machine
- there is no separate auth, no tokens to manage, no third-party server
- you get a UI tailored to triaging PRs, reviews and issues the way you want it
Goal
Once published, you should be able to launch the dashboard with a single command:
npx better-githubThat will start a local server using the bundled build and open the dashboard in your browser. All GitHub data is fetched on demand by shelling out to gh.
Requirements
- GitHub CLI authenticated via
gh auth login - Node 20+ to run the published CLI
Development
bun install
bun --bun run devThe dev server runs on http://localhost:8765.
Other scripts
bun --bun run build # production build
bun --bun run preview # preview the production build
bun --bun run test # run vitest
bun --bun run lint # eslint
bun --bun run format # prettier + eslint --fix
bun --bun run check # prettier checkStack
- TanStack Start (file-based routing, SSR, server functions)
- TanStack Query, Form, Table
- Tailwind CSS + shadcn/ui
License
MIT
