GitHub Star Manager

Introduction

When to Use

• Users need to automatically discover and star GitHub projects from content
• Users need to track updates of GitHub Star projects
• Users need to monitor version releases of dependent libraries
• Users need to view project activity and health
• Users need to manage a large number of starred repositories
• Users need to quickly browse and filter Star projects
• Users need to generate visual reports for projects

Module Description

Core Functions

1. Conversation Module: Automatic Discovery and Starring

• "Analyze this article and star the projects in it"
• "Find GitHub projects from this screenshot and star them"
• "Star all GitHub projects mentioned in [content]"

1. Content Extraction and Context Analysis
   • Text/URL: Use WebFetch to get article content and parse GitHub URLs
   • Screenshot/image: Use image analysis MCP to extract text and identify project references
2. Repository Discovery and Intelligent Matching
   • Direct matching: Complete GitHub URLs found in the content
   • Search by name: Use

     gh search repos

     when only the project name is available
   • Context relevance verification: Check whether topics, description, and technology stack match
3. Check if already starred
   bash

   gh api user/starred/owner/repo 2>/dev/null

4. Star the repository
   bash

   gh repo star owner/repo

5. Generate report
   • List of newly starred repositories
   • Already starred repositories (skipped)
   • Repositories requiring manual confirmation

2. Update Tracking

• Version detection: Detect new Releases and Tags of projects
• Activity monitoring: Track recent Commit activity
• Change summary: Use AI to summarize version change content

4. Intelligent Analysis

• Project summary: Automatically generate description of core functions of the project
• Value assessment: Analyze the matching degree of the project with your areas of interest (high/medium/low)
• Health indicators: Project maintenance status, Stars growth trend

5. HTML Visual Dashboard

• Information-dense cards: Display more projects on one screen
• Color-coded status: Active/recently updated/not updated for a long time at a glance
• Filter and search: Filter by status, value, keywords
• Expand details: Click the card to view more information

Dependencies

System Dependencies

brew install python3

sudo apt-get install python3

Python Packages

requests

pip install requests

python-dotenv

pip install python-dotenv

openai

pip install openai

Dependency Package File

pip install -r assets/requirements.txt

Usage

1. Environment Preparation

Method 1: Use .env configuration file (recommended)

# 1. Copy the sample configuration file
cp .env.example .env

# 2. Edit the .env file and fill in your API keys
# GITHUB_PAT=ghp_xxxxxxxxxxxxxxxxx
# OPENAI_API_KEY=sk-xxxxxxxxxxxx

# 3. Install dependencies
pip install -r requirements.txt

Method 2: Environment Variables

# Set environment variables directly
export GITHUB_PAT="your_github_pat_token"
export OPENAI_API_KEY="your_openai_api_key"

How to Get GitHub PAT

1. Visit https://github.com/settings/tokens
2. Click "Generate new token (classic)"
3. Select permissions:

   • public_repo

     (access public repositories)
   • If you need to access private Stars, check

     repo

4. Copy the token after generation (it will only be displayed once!)

• No Token: 60 requests/hour limit
• With Token: 5000 requests/hour limit

2. Start Dashboard (recommended)

# Export data and open Dashboard
python scripts/main.py --export --user your_username && open dashboard.html

dashboard.html

assets/dashboard.example.html

• 📊 Overview: Total number of projects, active projects this week, number of new versions
• 🔍 Filter: Filter by status (active/recently updated/not updated for a long time), value (high/medium)
• 🔎 Search: Search by project name, description, tags
• 📦 Card: Display project name, description, language, tags, Stars, update time, value assessment
• 🖱️ Click the card: Expand detailed information (creation time, Forks, Issues, collection reason)
• 🔗 Quick jump: Click the GitHub icon to go directly to the project

3. First synchronization (establish baseline)

python scripts/main.py --init --user your_username --limit 50

4. Check for updates

python scripts/main.py --check --user your_username

5. Generate full report

python scripts/main.py --report --user your_username --days 7

6. Run regularly (recommended)

# Check once a week
python scripts/main.py --check --user your_username --weekly

Configuration and Customization

Configuration File

assets/categories.yaml

assets/tags.json

assets/.env.example

~/.github-star-tracker/

Applicable Scenarios

• Developers: Timely understand version updates of dependent libraries
• Technology enthusiasts: Track the latest trends in the AI/open source field
• Project managers: Monitor the progress of competitors or related projects

Differences from Other Skills

Reference Documents

• SKILL-GUIDE.md - Skill development guide
• AGENTS.md - Project collaboration specifications