GithubStarsManager · AI Nav City

Core facts

Read by a script from the official API, not rewritten by a model.

Repository: https://github.com/AmintaCCCP/GithubStarsManager
License: MIT
Languages: TypeScript
Maintainer: AmintaCCCP
Homepage: https://gsm.aminta.top
Verified: 2026-11-02

What it is

GitHub Stars Manager automatically syncs starred repos, uses AI to summarize and categorize them, and supports semantic search. Its frontend uses React 18, TypeScript and Tailwind CSS. The app has an optional Express + SQLite backend. The app also works without a backend, as a pure frontend using localStorage.

Main features

Release tracking filters assets by platform and file type, saves custom keyword rules, and downloads with one click, in the browser or straight into aria2.
Smart Asset Filters match assets by keywords such as dmg, mac, arm64 and aarch64.
When pushing to GitHub Lists, each local category is written back as a same-named GitHub List, with existing lists overwritten and missing lists created private by default.

Getting started

Pre-built backend and frontend images are available on GHCR, so no local build is required.
Alternatively, download the source code or clone the repository.
In the Docker quick start for the backend server, the frontend is on port 8080 and the backend is on port 3000.
To set up an AI service, open Settings, add an AI config, enter the endpoint and key, pick a model, then test the connection.
To set up WebDAV backup, open Settings, add a WebDAV config, enter the server URL, username, password and path, test the connection, then enable auto-backup.

From the README · bash

docker pull ghcr.io/amintacccp/github-stars-manager-server:latest
docker pull ghcr.io/amintacccp/github-stars-manager-frontend:latest
docker-compose up -d

From the README · bash

API_SECRET=replace-with-a-long-random-secret
docker compose -f docker-compose.fullstack.yml up -d

From the README · bash

docker-compose up -d

From the README · bash

# 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:latest

From the README · bash

cd server
npm install
npm run dev

Who it is for

The project lists developers with hundreds or thousands of stars as who it is for. It also lists people who systematically track releases. The Repository Q&A Assistant does not index the whole repository.

After the embedding model of Vector Semantic Search is changed, the index must be rebuilt, because different models produce incompatible vector dimensions. Find similar repositories requires Vector Semantic Search to be configured and enabled; without it, the action is unavailable. Pure frontend mode, with no backend, hides the MCP settings page.

The MCP token is separate from the backend API secret. Without a backend, data is stored in the browser's localStorage. The API secret variable is a Bearer token for API authentication, and authentication is disabled if it is unset.

The server port variable has a default of 3000. The author says the app is entirely written by AI, mainly for their personal requirement. The project is licensed under MIT.

Related tools listed on this site.