Skip to content

izumi0uu/better-github-stars-manager

Repository files navigation

English · 简体中文

Better GitHub Stars Manager

Chrome Web Store Chrome MV3 TypeScript Latest release License: MIT

A Chrome extension for heavy GitHub users — local-first, zero-server, personal. It turns https://github.com/{user}?tab=stars into a fast, searchable, taggable, filterable, annotatable workspace so you can manage thousands of stars without leaving GitHub.

Install from the Chrome Web Store: Get it on the Chrome Web Store

Better GitHub Stars Manager

Table of Contents

Why Better GitHub Stars Manager?

GitHub Stars is good for bookmarking, but it does not hold up for long-term organization.

Once your stars grow into the hundreds or thousands, the native list becomes hard to manage. In the AI era, GitHub projects multiply exponentially — you star all kinds of things, then forget where you saved them or what they were called. The real pain points:

  • pagination hides the full picture of your stars
  • no personal tagging system
  • no real notes layer
  • hard to revisit what you saved and why

Better GitHub Stars Manager makes GitHub Stars genuinely manageable for heavy users.

Features

  • All stars in one place Load your starred repositories into a virtualized table that stays usable even with very large collections.

  • Fast search and filtering Search across repository name, description, topics, and notes. Filter by language, tags, and untagged items.

  • Floating toggle button On your own GitHub stars page, a floating button switches to the management panel with one click.

  • Custom tags and notes Add your own labels and notes so your stars become a working library instead of a passive list.

  • Auto-suggested tags Turn repository topics and language into suggested tags with one click or in bulk.

  • Incremental sync and full rescan Pull in newly starred repositories quickly, and run a full rescan when you want to reconcile unstars while keeping your annotations.

  • Repo-page tag chip See and edit your tags directly on individual GitHub repository pages.

  • Cross-device annotation sync Push and pull your tags and notes through your own private GitHub Gist.

  • Gist-backed storage layer Keep your annotation layer in a dedicated secret Gist so it is portable, recoverable, and easy to sync across devices without a backend.

Screenshots

Better GitHub Stars Manager running on GitHub Stars Better GitHub Stars Manager Plugin

How to Use

  1. Install the extension from the Chrome Web Store.
  2. Open the extension, jump to the Options page, and paste a GitHub personal access token.
  3. Visit your GitHub stars page: https://github.com/{you}?tab=stars.
  4. Run Sync to import your stars.
  5. Search, filter, tag, and add notes as you review repositories.
  6. Use Push and Pull if you want your annotations to travel across devices.

Install

Install Better GitHub Stars Manager from the Chrome Web Store:

Get it on the Chrome Web Store

Then:

  1. Click Add to Chrome
  2. Open the extension Options page
  3. Create a GitHub token with the permissions below
  4. Paste the token into Options and click Save & verify
  5. Visit https://github.com/{you}?tab=stars
  6. Run Sync to import your stars

Chrome will handle updates automatically after installation from the store.

Token setup

Step 1: Create a fine-grained personal access token and click Generate new token.

Create a fine-grained token

Step 2: For repository access, choose Public repositories.

Choose repository access

Step 3: Add Gists: read and write so cross-device sync can work.

Grant Gists permission

Recommended GitHub token permissions:

  • Public Repositories (read)
  • Gists (read/write)

Fine-grained token Gist permissions are account-level (they cannot be scoped per gist). The extension creates a dedicated secret gist for sync.

Another way --> Local development install

pnpm install
pnpm build

Then in Chrome:

  1. Open chrome://extensions
  2. Enable Developer mode
  3. Click Load unpacked
  4. Select the dist/ folder
  5. Open the extension Options page and continue with the token setup above

Privacy and Storage

The extension is designed to keep the heavy data local and sync only the personal annotation layer.

  • Star metadata is stored locally in IndexedDB.
  • Lightweight config lives in chrome.storage.local.
  • Tags, notes, and tag metadata can be stored in a dedicated secret Gist under your own GitHub account.

Push / Pull only sync your annotation layer:

  • Push uploads tags, notes, and tag metadata to your private Gist.
  • Pull merges the latest tags, notes, and tag metadata back into the local database.
  • Star metadata itself stays local and is always reconstructed from GitHub.

There is no custom backend and no separate app account.

For a store-ready privacy statement, see docs/privacy-policy.md.

License

MIT — see LICENSE.

Copyright (c) 2026 izumi0uu.

Friendly Links

Contributing

Issues and PRs are welcome at the repository.

About

Manage your GitHub starred repos: tag, note, filter, search across thousands of stars. Chrome MV3 extension.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors