中文文档 | 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) |
| 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
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
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
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.
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
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 |
| Category | Category management, category sorting, default category override rules |
| Data Management | Data import/export, clear local data, reset all data |
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
- 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.
You can also run this application using Docker. See DOCKER.md for detailed instructions on how to build and deploy using Docker. 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 --buildFrontend on port 8080, backend on port 3000. Data persisted in a Docker volume.
cd 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.
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.






