中文文档 | English
Tired of starring everything and finding nothing?
GitHub Stars Manager automatically syncs your starred repos, uses AI to summarize and categorize them, and lets you find anything with semantic search. Track releases, filter assets, and one‑click download—smarter than manual tags, simpler than GitHub.
| Feature | Description |
|---|---|
| Auto-sync Stars | Connect your GitHub token to automatically pull all starred repositories |
| AI Summaries & Categories | Generate tags, topics, and short README overviews using AI |
| Semantic Search | Find repos by intent, not exact names |
| Release Tracking | Subscribe to repos and see new versions in one unified timeline |
| One‑click Downloads | Expand release assets and download instantly |
| Smart Asset Filters | Match assets by keywords (dmg / mac / arm64 / aarch64) |
| Fork Management | View, sync upstream, and trigger GitHub Actions workflows on forked repos |
| Network Proxy | HTTP / SOCKS5 proxy with protocol-level connection testing |
| Remote Download (aria2) | Send release assets to aria2 for download via JSON-RPC |
| Diagnostic Logs | Unified frontend/backend log viewer with debug capture mode |
| Bilingual Wiki Jump | Deepwiki (EN) or zread (ZH) based on repository language |
| Packaged Client | No environment setup required—download and run |
Deploy an Express + SQLite backend for:
- Cross-device Sync — Share data between browsers and devices
- CORS-free API Proxying — AI and WebDAV calls route through the server
- Encrypted Token Storage — API keys stored securely, never exposed to browser
- Network Proxy Forwarding — Route all outbound requests (GitHub, AI, WebDAV) through HTTP/SOCKS5 proxy
- RPC Download Proxy — Forward aria2 download requests through the server with encrypted secret storage
Features:
- AI Batch Analysis — Select multiple repos and use AI to auto-generate descriptions, tags, and categories; supports pause/resume
- Repo Card Display — Shows stars, forks, language, default branch status; supports expanding README preview
- Category Sidebar — Drag to reorder categories, custom category colors, collapse/expand sidebar; supports locking categories to prevent AI overrides
- Bulk Action Toolbar — Bulk categorize to a specified category, bulk restore AI analysis results
- Multi-layout Support — Adapts layout for desktop and tablet
- Subscription Indicators — Shows which repos have Release update subscriptions
- AI Analysis Status — Shows analyzed / not analyzed / analysis failed; filter by analysis status
Screenshot:
Features:
- Release Subscription Management — Subscribe/unsubscribe to repo releases; supports bulk unsubscribe
- Timeline Display — Lists all new releases in reverse chronological order; shows read/unread status
- Smart Asset Filtering — Filter by platform (macOS / Windows / Linux / ARM); filter by file type (dmg / zip / deb / rpm / apk)
- Custom Filter Rules — Save custom keyword filter rules
- Expand & Download — Expand release assets list, one-click copy download links; shows file size
- Release Details — Displays version number, release name, time since release
- Multi-view Modes — List view / Grid view toggle
- Paginated Loading — Load historical release records page by page
- Refresh Status Indicator — Shows last refresh time
Screenshot:
Features:
- Five Discovery Channels — Trending / Hot Release / Most Popular / Topic / Search
- Trending Time Range — Three time dimensions: Today / This Week / This Month
- Trending Filtering Rules — Updated within 30 days, 50+ stars, sorted by stars descending
- Platform Filtering — Filter by OS (All / macOS / Windows / Linux / Browser)
- Programming Language Filtering — Filter by language (JavaScript / TypeScript / Python / Go / Rust, etc.)
- AI Repo Analysis — One-click AI analysis for trending repos
- Subscribe to Trending Repos — Add interesting trending repos to subscription list
- Mobile Tab Navigation — Channel switching adapted for mobile devices
About Trending:
Trending data is sourced from GitHub's trending RSS feed, auto-updated every 30 minutes. Perfect for discovering emerging hot projects, tracking tech trends, and finding learning directions.
Screenshot:
Features:
- Fork Listing — Automatically fetches all your forked repos with upstream update detection
- One-click Sync — Merge upstream changes into any branch with conflict handling
- GitHub Actions — View and trigger workflow runs directly from fork cards
- Read/Unread Tracking — Pulse indicator for forks with new upstream commits
- Search & Pagination — Full-text search, configurable page sizes
Screenshot:
Features:
- Multi-dimensional Search — Keyword search, repo status filter, tag filter, language filter, platform filter
- AI Analysis Status Filter — Analyzed / Not Analyzed / Analysis Failed / Edited
- Release Subscription Filter — Subscribed / Not Subscribed to Release
- Category Status Filter — Category Locked / Not Locked
- Shortcut Keys Support — Displays search shortcut hints
- Search Statistics — Shows result count and filter conditions
- Search Demo Mode — Demonstrates semantic search capabilities
Screenshot:
Settings Groups:
| Group | Features |
|---|---|
| General | Language toggle (ZH/EN), theme settings |
| AI Config | Configure OpenAI / Anthropic / Ollama / compatible APIs; supports custom endpoints and keys |
| WebDAV | Backup config for Jianguoyun, Nextcloud, ownCloud, and standard WebDAV services |
| Backup | Backup history, manual backup/restore, incremental backup |
| Backend Server | Connect to self-hosted backend, API key authentication, sync status indicator |
| Network | HTTP/SOCKS5 proxy config with protocol-level testing; aria2 RPC remote download setup |
| Category | Category management, category sorting, default category override rules |
| Data Management | Data import/export, clear local data, reset all data |
Screenshot:
Features:
- Multi AI Provider Support — OpenAI (GPT-3.5/GPT-4), Anthropic (Claude), Ollama (local models), any OpenAI-compatible API
- Custom Endpoints — Supports privately deployed AI services
- Connection Testing — Test API connection after configuration
- AI Model Selection — Choose the specific model to use
Screenshot:
- Frontend: React 18 + TypeScript + Tailwind CSS
- State Management: Zustand
- Icons: Lucide React + Font Awesome
- Build Tool: Vite
You can download desktop client here: https://github.com/AmintaCCCP/GithubStarsManager/releases
- Download the source code, or clone the repository
- Navigate to the directory, and open a Terminal window at the downloaded folder.
- Run
npm installto install dependencies andnpm run devto build
💡 When running the project locally using
npm run dev, calls to AI services and WebDAV may fail due to CORS restrictions. To avoid this issue, use the prebuilt client application or build the client yourself. Alternatively, run the backend server (cd server && npm run dev) to proxy API calls and avoid CORS entirely.
Pre-built backend image is available on GHCR — no local build required:
docker pull ghcr.io/amintacccp/github-stars-manager-server:latest
docker-compose up -dIf the package is private, run
docker login ghcr.iofirst (use a PAT withread:packagesscope).
See DOCKER.md for detailed instructions. The Docker setup handles CORS properly and allows you to configure any AI or WebDAV service URLs directly in the application.
The app works fully without a backend (pure frontend, localStorage). An optional Express + SQLite backend adds:
- Cross-device sync: Share data between browsers/devices
- CORS-free proxying: AI and WebDAV calls go through the server, avoiding browser CORS issues
- Token security: API keys stored encrypted on server, never exposed to browser network tab
docker-compose up -dFrontend on port 8080, backend on port 3000. Data persisted in a Docker volume.
To customize, create a .env file:
API_SECRET=your-secret
ENCRYPTION_KEY=your-key
BACKEND_IMAGE_TAG=v0.6.2 # pin a specific version (default: latest)# Basic — no auth, port 3000
docker run -d --name github-stars-backend \
-v github-stars-data:/app/data \
-p 3000:3000 \
ghcr.io/amintacccp/github-stars-manager-server:latest
# With custom secret and encryption key
docker run -d --name github-stars-backend \
-v github-stars-data:/app/data \
-p 3000:3000 \
-e API_SECRET="your-secret" \
-e ENCRYPTION_KEY="your-key" \
ghcr.io/amintacccp/github-stars-manager-server:latestcd server
npm install
npm run dev| Variable | Required | Description |
|---|---|---|
API_SECRET |
No | Bearer token for API authentication. If unset, auth is disabled. |
ENCRYPTION_KEY |
No | AES-256 key for encrypting stored secrets. Auto-generated if unset. |
PORT |
No | Server port (default: 3000) |
- Open Settings panel in the app
- Find "Backend Server" section
- Enter API Secret (if configured)
- Click "Test Connection" — green indicator means connected
- Use "Sync to Backend" / "Sync from Backend" to transfer data
The app supports multiple AI providers. Configure yours in the Settings panel:
- OpenAI: GPT-3.5 / GPT-4
- Anthropic: Claude
- Ollama: local models with no API key needed
- Any OpenAI-compatible API: custom endpoint + key
Steps: open Settings, add an AI config, enter your endpoint and key, pick a model, then test the connection.
The app supports routing all outbound requests through a proxy:
- HTTP Proxy — Standard HTTP CONNECT tunneling with optional authentication
- SOCKS5 Proxy — Full SOCKS5 support including username/password auth (RFC 1929)
- Protocol-level Testing — Connection test performs actual protocol handshakes, not just TCP connect
- Encrypted Storage — Proxy passwords are encrypted at rest with AES-256-GCM
Configure in Settings → Network tab (available in Electron client or with backend server).
Send release download links directly to an aria2 daemon:
- Start aria2 with RPC enabled:
aria2c --enable-rpc --rpc-listen-port=6800 - Open Settings → Network → Remote Download
- Enter host, port, and optional secret
- Test connection, then save
- Release asset buttons will now queue downloads to aria2
Works in both backend-proxied mode and client-only mode (direct browser→aria2 connection).
Back up and sync your data via any standard WebDAV service:
- Jianguoyun (坚果云): recommended for users in China
- Nextcloud: self-hosted cloud storage
- ownCloud: enterprise-grade option
- Any standard WebDAV server
Steps: open Settings, add a WebDAV config, enter the server URL, username, password, and path, test the connection, then enable auto-backup.
The build output is a static site, so it deploys anywhere static hosting is supported:
- Netlify: connect your fork, set build command
npm run build, publish directorydist - Vercel: same as Netlify — import repo, build runs automatically
- GitHub Pages: push the
distfolder to agh-pagesbranch - Cloudflare Pages: connect repo, build command
npm run build, outputdist - Self-hosted: serve the
distfolder with any HTTP server (nginx, Caddy, etc.)
For Docker deployment see the Backend Server section above.
Developers with hundreds/thousands of stars People who systematically track releases "Lazy-efficient" users who don't want manual tagging
- The backend is optional but recommended for web deployment. Without it, all data is stored in your browser's localStorage — back up important data regularly.
- I can't write code, this app is entirely written by the AI, mainly for my personal requirment. If you have a new feature or meet a bug, I can only try to do it, but I can't guarantee it, because it depends on the AI to do it successfully.😹
Contributions are welcome!
- Fork the project
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
MIT — see LICENSE for details.