A keyboard-friendly workspace for GitHub issues, pull requests, and code.
Open GitHut · Demos · Run locally · Contribute
GitHut brings your GitHub repositories into one browser window. Read an issue beside your Inbox, open the pull request that fixes it, and review the diff without losing your place. Sign in with GitHub to use your existing repositories and notifications.
Drag a tab to dock it. Hold the issue tab, drag it to the right edge, and release when the split preview appears. GitHut calls each group of tabs an island.
View a still image · Dock using the tab menu
For repository triage, use Display → Grouping to organize issues and pull requests by assignee, label, or milestone. For a failing build, open Actions and select a job to read its step logs.
Press Ctrl K (⌘ K on macOS) to open the command palette, or ? for the shortcuts on the current page.
You’ll need Bun, Node.js 22.12 or later, and a GitHub account.
-
Clone the repository and install its dependencies:
git clone https://github.com/daedlock/githut.git cd githut bun install --frozen-lockfile cp .dev.vars.example .dev.vars -
Register a GitHub OAuth app for local development. Set its Homepage URL to
http://localhost:5173and its Authorization callback URL tohttp://localhost:5173/api/auth/callback. -
In
.dev.vars, fill inGITHUB_CLIENT_IDandGITHUB_CLIENT_SECRETfrom that OAuth app. ForOAUTH_STATE_SECRET, generate a separate value withopenssl rand -hex 32. This file is ignored by Git. -
Build the static assets once, then start Vite and the local Cloudflare Worker:
bun run build bun run dev
Open localhost:5173 and sign in. The Worker handles the OAuth callback; the browser uses the resulting token to call GitHub. GitHut requests the
repo,read:user, andread:orgscopes, so authorized actions such as posting a review also appear on GitHub.
The React app uses TanStack Router and Query for navigation and GitHub data, and Shiki for code highlighting. The Cloudflare Worker handles sign-in and uploads. Run bun test and bunx tsc --noEmit to check your changes.
Read the contributing guide, report a bug, or suggest a feature.
GitHut is licensed under the MIT License.