How amintacccp/githubstarsmanager works
GithubStarsManager is a local-first desktop/web app for organizing and finding GitHub stars, with AI analysis, semantic search, repository Q&A, release tracking, discovery, and MCP access. The central workflow is to sync starred repositories, enrich them with AI-generated summaries and categories, then search or act on the organized collection. The graph also shows Q&A’s commit-pinned sessions and local history. Major feature branches are supported by the README and tree; several internal links are omitted where the sampled excerpts do not establish call ownership.
Main entry points: useAppStore.ts Application State · App.tsx Application UI · RepositoryList.tsx Repository Views · useRepositoryAnalysisJob.ts Analysis Workflow
Components 20
Application
- Application UI
src/App.tsx - Application State
src/store/useAppStore.ts
Star Management
- Repository Views
src/components/RepositoryList.tsx - Star Sync
src/services/autoSync.ts
AI and Search
- Analysis Workflow
src/features/repositories/hooks/useRepositoryAnalysisJob.ts - AI Analysis
src/services/aiAnalysisHelper.ts - Vector Search
src/services/vectorSearchService.ts
Product Features
- Repository Q&A
src/features/repository-chat/hooks/useRepositoryChat.ts - Chat Runner
src/services/repositoryChatRunner.ts - Chat Sessions
src/features/repository-chat/hooks/useRepositoryChatSessions.ts - Chat History
src/services/repositoryChatStorage.ts - Release Tracking
src/features/releases/hooks/useReleaseTimelineActions.ts - Discovery
src/features/discovery/hooks/useDiscoveryActions.ts - MCP Access
server/src/mcp/server.ts
Runtime Services
- Backend API
server/src/index.ts - Desktop Runtime
electron/main.js
Other components
- User
- GitHub API
- AI Provider
- Cloudflare Vectorize
Connections 18
- User → Application UI: uses
- Application UI → Application State: reads state
- Application UI → Repository Views: presents
- Repository Views → Application State: reads and updates
- Star Sync → GitHub API: syncs stars
- Analysis Workflow → AI Analysis: runs analysis
- Analysis Workflow → Application State: updates repositories
- AI Analysis → AI Provider: requests enrichment
- Vector Search → Cloudflare Vectorize: searches vectors
- Repository Views → Vector Search: finds similar
- Repository Q&A → Chat Runner: runs turn
- Repository Q&A → Chat History: saves messages
- Chat Sessions → Chat History: manages sessions
- Chat Sessions → GitHub API: resolves commit
- Release Tracking → Application State: uses release state
- Discovery → Application State: uses discovery state
- MCP Access → Backend API: serves tools
- Desktop Runtime → Application UI: hosts UI