Skip to content

pynickle/gitpulse

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

363 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

GitPulse β€” GitHub Work Dashboard

Track notifications, issues, pull requests, and repositories from one focused workspace. No tab-switching, no noise.

AGPL-3.0 Nuxt 4 Bun


Features

πŸ“¬ Notifications

Grouped by reason β€” mention, review_requested, ci_activity, security_alert, assign, state_change, subscribed and more. Unread items have a blue indicator. Click Mark as read to dismiss, or let the 60-second auto-refresh catch new ones without reloading the page.

🎯 Issues & Pull Requests

Search-backed lists with quick filters (open / closed / merged). Click any row to open a slide-over detail panel showing the full timeline, labels, assignees, and action buttons β€” no page navigation needed.

✨ Custom Tabs

Create unlimited tabs backed by real GitHub search queries. Paste any GitHub search qualifier into the tab editor β€” it just works. Drag-and-drop to reorder, group tabs into named folders.

πŸ–¨ Markdown + Diagrams

Comments render with rich Markdown, syntax-highlighted code blocks, and Mermaid diagrams β€” sequence charts, flowcharts, Gantt β€” inline where they belong.

🌐 i18n

Built-in English and Simplified Chinese, auto-detected from your browser.

πŸŒ™ Dark Mode

Adaptive dark mode styling keeps the dashboard comfortable in low-light environments and aligned with the system theme.

πŸ“‚ Repositories

Paginated list of your repos with quick links to each. A fast way to jump to a project without leaving the dashboard.


Why GitPulse?

GitHub's own interface has you bouncing between tabs, pages, and repos to stay on top of everything. GitPulse brings it all into one single-page workspace:

GitHub.com GitPulse
Notifications + Issues + PRs Separate pages, lots of back/forth One dashboard, four tabs
Custom saved searches Bookmarks or URL hacks Built-in tab manager with drag-and-drop
Interface focus Nav bar, project panel, sidebar noise Only the GitHub activity you care about

Quick Start

Runtime uses Bun. Start the dev server:

bun install
bun run dev

Open the URL shown in terminal and paste your GitHub token on the landing page.

To get a token, run gh auth token β€” the token inherits the permissions you granted to the GitHub CLI, which typically includes organization-level access.


Try It Online

Visit gitpulse.euphony.ink β€” an official demo running in non-personal mode. Paste a GitHub token or sign in with OAuth to try the dashboard instantly.


Self-hosting

GitPulse has two deployment modes, controlled by environment variables. At least one must be enabled, or the app refuses to start.

Non-personal Mode (multi-user)

Users sign in by pasting a GitHub token or via GitHub OAuth. Suitable for teams or hosted deployments.

Environment Variable Required Default Description
NUXT_SESSION_PASSWORD Yes β€” 32-byte hex key for session encryption
NUXT_AUTH_PAT_ENABLED No true Allow token-based login
NUXT_AUTH_GITHUB_OAUTH_ENABLED No β€” Allow OAuth login
NUXT_OAUTH_GITHUB_CLIENT_ID If OAuth β€” GitHub OAuth app client ID
NUXT_OAUTH_GITHUB_CLIENT_SECRET If OAuth β€” GitHub OAuth app secret

Personal Mode (single-user, self-hosted)

A password-gated vault with a pre-configured token. On each new browser you see a lock screen; optionally tick "Remember this device" to stay logged in.

Environment Variable Required Default Description
NUXT_AUTH_PERSONAL_MODE_ENABLED Yes β€” Enable personal mode
NUXT_PERSONAL_TOKEN Yes β€” GitHub token baked into the server
NUXT_PERSONAL_MODE_PASSWORD Yes β€” Lock-screen password
NUXT_PERSONAL_COOKIE_SECRET Yes β€” Secret for signing "remember me" cookies

FAQ

Does GitPulse store my token?

No. Your token is kept in an encrypted server session cookie β€” it never touches a database. When you close the browser, the session ends.

How do I log out?

Click your avatar in the left activity bar β†’ Logout. Your session cookie is cleared.


License

GNU Affero General Public License v3.0 β€” see LICENSE.

About

🎨 A GitHub dashboard with custom tab groups for your notifications, issues, and PRs

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors