{"id":49579754,"url":"https://github.com/amirhmoradi/starred","last_synced_at":"2026-05-03T18:39:15.485Z","repository":{"id":334513479,"uuid":"1141660100","full_name":"amirhmoradi/starred","owner":"amirhmoradi","description":"Automatically categorize your GitHub starred repositories using AI (Claude, GPT, or Gemini), export to Markdown, and optionally sync with GitHub star lists.","archived":false,"fork":false,"pushed_at":"2026-03-15T20:31:18.000Z","size":545,"stargazers_count":40,"open_issues_count":0,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-16T08:14:15.137Z","etag":null,"topics":["ai-categorize-github-stars","awesome-list-generator","categorize-github-stars-ai","claude-github-stars","developer-tools","gemini-github","github-automation","github-bookmarks-organizer","github-lists-automation","github-profile-readme-stars","github-star-tracker","github-starred-repos-manager","github-stars-export","github-stars-manager-tool","github-stars-organizer","gpt-github-organizer","organize-github-bookmarks","organize-github-starred-repositories","starred-repos-to-markdown","starred-repositories-markdown"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amirhmoradi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-25T07:25:40.000Z","updated_at":"2026-03-15T20:31:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/amirhmoradi/starred","commit_stats":null,"previous_names":["amirhmoradi/starred"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/amirhmoradi/starred","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amirhmoradi%2Fstarred","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amirhmoradi%2Fstarred/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amirhmoradi%2Fstarred/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amirhmoradi%2Fstarred/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amirhmoradi","download_url":"https://codeload.github.com/amirhmoradi/starred/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amirhmoradi%2Fstarred/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32580620,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T06:36:36.687Z","status":"ssl_error","status_checked_at":"2026-05-03T06:36:09.306Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-categorize-github-stars","awesome-list-generator","categorize-github-stars-ai","claude-github-stars","developer-tools","gemini-github","github-automation","github-bookmarks-organizer","github-lists-automation","github-profile-readme-stars","github-star-tracker","github-starred-repos-manager","github-stars-export","github-stars-manager-tool","github-stars-organizer","gpt-github-organizer","organize-github-bookmarks","organize-github-starred-repositories","starred-repos-to-markdown","starred-repositories-markdown"],"created_at":"2026-05-03T18:39:14.739Z","updated_at":"2026-05-03T18:39:15.476Z","avatar_url":"https://github.com/amirhmoradi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ⭐ Starred — AI-Powered GitHub Stars Organizer\n\n\u003e **Automatically categorize, organize, and showcase your GitHub starred repositories using AI (Claude, GPT-4, Gemini)**\n\n[![GitHub Stars](https://img.shields.io/github/stars/amirhmoradi/starred?style=social)](https://github.com/amirhmoradi/starred/stargazers)\n[![GitHub Actions](https://img.shields.io/github/actions/workflow/status/amirhmoradi/starred/update-starred.yml?label=auto-update)](https://github.com/amirhmoradi/starred/actions)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)\n\n**Starred** transforms your messy GitHub stars into a beautifully organized, AI-categorized collection. Perfect for developers who star repos and forget about them!\n\n[🚀 Quick Start](#-quick-start) • [📸 Examples](#-example-output) • [🤖 AI Providers](#-supported-ai-providers) • [📖 Documentation](#-cli-reference)\n\n---\n\n## 🎯 Why Starred?\n\n**The Problem:** You've starred hundreds of GitHub repositories. Finding that Docker tool or that React library you starred months ago? Nearly impossible.\n\n**The Solution:** Let AI organize your stars automatically.\n\n| Before Starred | After Starred |\n|----------------|---------------|\n| 500+ unorganized stars | Neatly categorized by topic |\n| \"Where's that CLI tool?\" | Searchable markdown docs |\n| Empty profile README | Auto-updated showcase |\n| Manual GitHub Lists | AI-synced categories |\n\n---\n\n## ✨ Key Features\n\n### 🤖 Multi-AI Support\nUse **Claude**, **GPT-4**, or **Gemini** to intelligently categorize repositories based on description, language, topics, and README content.\n\n### 📝 Markdown Export\nGenerates a beautiful `STARRED_REPOS.md` with table of contents, categories, star counts, and descriptions.\n\n### 👤 Profile README Integration\nAutomatically updates your GitHub profile README with a curated showcase of your starred repos.\n\n### 🔄 GitHub Actions Automation\nSet it and forget it — runs daily to keep your collection organized as you star new repos.\n\n### 📊 GitHub Lists Sync\nOptionally sync your AI-generated categories to native GitHub Star Lists.\n\n### 🎨 Fully Customizable\nDefine your own categories, preferences, and display options.\n\n---\n\n## 🚀 Quick Start\n\n### Option 1: GitHub Actions (Recommended — 5 minutes)\n\n1. **Fork or use this template**\n   \n   [![Fork](https://img.shields.io/badge/Fork-Repository-blue?style=for-the-badge\u0026logo=github)](https://github.com/amirhmoradi/starred/fork)\n   [![Use Template](https://img.shields.io/badge/Use-Template-green?style=for-the-badge\u0026logo=github)](https://github.com/new?template_name=starred\u0026template_owner=amirhmoradi)\n\n2. **Add secrets** in Settings → Secrets → Actions:\n   \n   | Secret | Required | Get it from |\n   |--------|----------|-------------|\n   | `GH_PAT` | ✅ | [Create PAT](https://github.com/settings/personal-access-tokens/new) with `starring:read` |\n   | `ANTHROPIC_API_KEY` | Pick one | [Anthropic Console](https://console.anthropic.com/) |\n   | `OPENAI_API_KEY` | Pick one | [OpenAI Platform](https://platform.openai.com/api-keys) |\n   | `GEMINI_API_KEY` | Pick one | [Google AI Studio](https://aistudio.google.com/apikey) (**Free!**) |\n\n3. **Run the workflow**: Actions → Update Starred Repos → Run workflow\n\n4. **Check results** in `STARRED_REPOS.md` ✨\n\n### Option 2: Local / CLI Installation\n\n```bash\n# Install from source\ngit clone https://github.com/amirhmoradi/starred.git\ncd starred\npip install -e \".[all]\"\n\n# Set environment variables\nexport GH_TOKEN=\"ghp_your_token\"\nexport ANTHROPIC_API_KEY=\"sk-ant-xxx\"  # or OPENAI_API_KEY or GEMINI_API_KEY\n\n# Fetch your stars\nstarred fetch --username YOUR_USERNAME\n\n# Categorize with AI\nstarred categorize --preferences \"Focus on DevOps, AI tools, and web development\"\n\n# See your organized stars!\ncat STARRED_REPOS.md\n```\n\n---\n\n## 📸 Example Output\n\n### STARRED_REPOS.md Preview\n\n```markdown\n# ⭐ My Starred Repositories\n\n**847** repositories organized into **18** categories\n\n## 📑 Table of Contents\n- [🤖 AI \u0026 Machine Learning](#-ai--machine-learning) (142)\n- [🌐 Web Development](#-web-development) (98)\n- [⚙️ DevOps \u0026 Infrastructure](#-devops--infrastructure) (87)\n- [🔧 CLI Tools](#-cli-tools) (64)\n...\n\n## 🤖 AI \u0026 Machine Learning\n*Machine learning frameworks, LLMs, AI tools and utilities*\n\n- [langchain-ai/langchain](https://github.com/langchain-ai/langchain) `Python` ⭐ 95,000 - Build LLM applications\n- [openai/whisper](https://github.com/openai/whisper) `Python` ⭐ 72,000 - Speech recognition\n- [ggerganov/llama.cpp](https://github.com/ggerganov/llama.cpp) `C++` ⭐ 68,000 - Run LLMs locally\n...\n```\n\n### Profile README Integration\n\nYour GitHub profile automatically displays:\n\n```markdown\n### 🤖 AI \u0026 Machine Learning\n- [langchain-ai/langchain](https://github.com/langchain-ai/langchain) `Python` ⭐ 95,000\n- [openai/whisper](https://github.com/openai/whisper) `Python` ⭐ 72,000\n\n### ⚙️ DevOps \u0026 Infrastructure  \n- [docker/compose](https://github.com/docker/compose) `Go` ⭐ 34,000\n- [kubernetes/kubernetes](https://github.com/kubernetes/kubernetes) `Go` ⭐ 112,000\n\n*[View all 847 repositories →](STARRED_REPOS.md)*\n```\n\n---\n\n## 🤖 Supported AI Providers\n\n| Provider | Model | Cost | Speed | Quality |\n|----------|-------|------|-------|---------|\n| **Anthropic** | Claude Sonnet 4 | ~$0.02/run | Fast | ⭐⭐⭐⭐⭐ |\n| **OpenAI** | GPT-4o | ~$0.03/run | Fast | ⭐⭐⭐⭐⭐ |\n| **Google** | Gemini 2.0 Flash | **Free tier!** | Very Fast | ⭐⭐⭐⭐ |\n\nThe tool **auto-detects** which provider to use based on available API keys.\n\n```bash\n# Force a specific provider\nstarred categorize --provider gemini --model gemini-2.0-flash\nstarred categorize --provider openai --model gpt-4o-mini\nstarred categorize --provider anthropic --model claude-sonnet-4-20250514\n```\n\n---\n\n## 👤 Profile README Setup\n\n1. **Add placeholder tags** to your profile repo (`username/username/README.md`):\n\n```markdown\n## ⭐ My Starred Repositories\n\n\u003c!-- STARRED_REPOS_START --\u003e\n\u003c!-- Auto-generated content will appear here --\u003e\n\u003c!-- STARRED_REPOS_END --\u003e\n```\n\n2. **Enable the workflow** — the \"Update Profile README\" action will automatically:\n   - Update the section between the tags\n   - Copy the full `STARRED_REPOS.md` to your profile repo\n   - Add a link to view all stars\n\n---\n\n## 🔄 GitHub Lists Sync (Advanced)\n\nSync AI categories to **native GitHub Star Lists**:\n\n\u003e ⚠️ Requires browser cookie (GitHub has no official API for lists)\n\n```bash\n# Preview changes\nstarred sync --cookie \"$GH_COOKIE\" --dry-run\n\n# Apply changes\nstarred sync --cookie \"$GH_COOKIE\"\n\n# Reset and recreate all lists\nstarred sync --cookie \"$GH_COOKIE\" --reset\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eHow to get the cookie\u003c/strong\u003e\u003c/summary\u003e\n\n1. Go to `https://github.com/yourusername?tab=stars`\n2. Open DevTools (F12) → Network tab\n3. Refresh the page\n4. Click the first request → Headers\n5. Copy the `Cookie` value\n\nNote: Cookies expire every ~2 weeks.\n\n\u003c/details\u003e\n\n---\n\n## ⚙️ Configuration Options\n\n### Custom Categories\n\nCreate `categories.json`:\n\n```json\n[\n  {\"name\": \"🤖 AI \u0026 ML\", \"description\": \"Machine learning and AI tools\"},\n  {\"name\": \"🏠 Self-Hosted\", \"description\": \"Self-hosted alternatives to SaaS\"},\n  {\"name\": \"🚀 Starter Kits\", \"description\": \"Boilerplates and templates\"}\n]\n```\n\n```bash\nstarred categorize --categories categories.json\n```\n\n### AI Preferences\n\nGuide the AI with natural language:\n\n```bash\nstarred categorize --preferences \"\nI'm a DevOps engineer focused on Kubernetes.\nCreate categories for:\n- Container orchestration\n- CI/CD pipelines\n- Monitoring \u0026 observability\n- Infrastructure as Code\nSkip frontend and mobile categories.\n\"\n```\n\n### Environment Variables\n\n```bash\n# Required\nGH_TOKEN=ghp_xxxx              # GitHub Personal Access Token\n\n# LLM Provider (at least one)\nANTHROPIC_API_KEY=sk-ant-xxxx  # Anthropic Claude\nOPENAI_API_KEY=sk-xxxx         # OpenAI GPT\nGEMINI_API_KEY=xxxx            # Google Gemini (free tier available!)\n\n# Optional\nGH_USERNAME=yourusername       # Auto-detected if not set\nGH_COOKIE=...                  # For GitHub Lists sync\n```\n\n---\n\n## 📖 CLI Reference\n\n```\nstarred --help\n\nCommands:\n  fetch          Fetch starred repos from GitHub API\n  categorize     Categorize repos using AI\n  update-readme  Update README with starred repos section\n  sync           Sync with GitHub Star Lists\n  providers      List available LLM providers\n\nOptions:\n  --help         Show help message\n  --verbose      Enable debug logging\n\nExamples:\n  starred fetch --username myuser --with-readme\n  starred categorize --provider gemini --preferences \"Focus on Python tools\"\n  starred update-readme --readme ./README.md --include-toc --max-repos 100\n  starred sync --cookie \"$COOKIE\" --dry-run\n```\n\n---\n\n## 🆚 Comparison with Alternatives\n\n| Feature | **Starred** | StarListify | Astral | Manual |\n|---------|------------|-------------|--------|--------|\n| AI Categorization | ✅ Multi-provider | ⚠️ Gemini only | ❌ | ❌ |\n| GitHub Actions | ✅ Full automation | ⚠️ Basic | ❌ | ❌ |\n| Profile README | ✅ Auto-update | ❌ | ❌ | ✅ |\n| GitHub Lists | ✅ Sync | ✅ | ❌ | ✅ |\n| Open Source | ✅ MIT | ✅ MIT | ❌ | — |\n| Custom Categories | ✅ | ⚠️ | ❌ | ✅ |\n| Multi-LLM | ✅ Claude/GPT/Gemini | ❌ | ❌ | — |\n\n---\n\n## 📊 How It Works\n\n```\n┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐\n│  GitHub Stars   │────▶│   AI Analysis   │────▶│    Markdown     │\n│  (API fetch)    │     │ Claude/GPT/     │     │   Generation    │\n│                 │     │ Gemini          │     │                 │\n└─────────────────┘     └─────────────────┘     └─────────────────┘\n                                                        │\n                        ┌───────────────────────────────┼───────────────┐\n                        ▼                               ▼               ▼\n               ┌─────────────────┐            ┌─────────────────┐  ┌─────────┐\n               │ STARRED_REPOS.md│            │  Profile README │  │ GitHub  │\n               │   (full list)   │            │   (summary)     │  │  Lists  │\n               └─────────────────┘            └─────────────────┘  └─────────┘\n```\n\n1. **Fetch** — Downloads starred repos via GitHub API\n2. **Analyze** — AI categorizes based on metadata \u0026 README\n3. **Generate** — Creates organized Markdown documentation\n4. **Deploy** — Updates profile README automatically\n5. **Sync** — Creates GitHub Lists (optional)\n\n---\n\n## ❓ FAQ\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eHow much does it cost?\u003c/strong\u003e\u003c/summary\u003e\n\nVery affordable:\n- **Google Gemini**: Free tier available!\n- **Claude/GPT**: ~$0.02-0.05 per run for ~500 stars\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eHow often does it update?\u003c/strong\u003e\u003c/summary\u003e\n\nThe GitHub Action runs daily at 2 AM UTC. Customize the cron schedule or run manually anytime.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eCan I use my own categories?\u003c/strong\u003e\u003c/summary\u003e\n\nYes! Create a `categories.json` file or use `--preferences` to guide the AI with natural language.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eIs my data safe?\u003c/strong\u003e\u003c/summary\u003e\n\nOnly public repository metadata (name, description, language) is sent to the AI. No private data is shared.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eWhy do GitHub Lists need a cookie?\u003c/strong\u003e\u003c/summary\u003e\n\nGitHub doesn't provide an official API for star lists. The tool uses your browser session (cookie) to manage lists via the web interface.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eDoes it work with organizations?\u003c/strong\u003e\u003c/summary\u003e\n\nYes! Set `profile_repo` to `org-name/.github` in the workflow to update an organization's profile.\n\n\u003c/details\u003e\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n**Ideas for contributions:**\n- [ ] Additional LLM providers (Ollama, local models)\n- [ ] Export to Notion, Obsidian, Raindrop.io\n- [ ] Web UI for category management\n- [ ] Browser extension for cookie refresh\n- [ ] Semantic search over starred repos\n\n---\n\n## 📜 License\n\nMIT License — see [LICENSE](LICENSE) for details.\n\n---\n\n## 🙏 Acknowledgments\n\nInspired by [StarListify](https://github.com/nhtlongcs/StarListify) and the GitHub community.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eFound this useful? Give it a ⭐ to help others discover it!\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/amirhmoradi/starred/stargazers\"\u003e⭐ Star\u003c/a\u003e •\n  \u003ca href=\"https://github.com/amirhmoradi/starred/fork\"\u003e🍴 Fork\u003c/a\u003e •\n  \u003ca href=\"https://github.com/amirhmoradi/starred/issues\"\u003e🐛 Issues\u003c/a\u003e •\n  \u003ca href=\"https://github.com/amirhmoradi/starred/discussions\"\u003e💬 Discuss\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n\u003csub\u003e\n\u003cstrong\u003eKeywords:\u003c/strong\u003e github stars organizer, organize github starred repositories, ai categorize github stars, \ngithub starred repos manager, github profile readme stars, starred repositories markdown, github lists automation, \nclaude github stars, gpt github organizer, gemini github, awesome list generator, github star tracker, \ngithub bookmarks organizer, developer tools, github automation, starred repos to markdown, github stars export,\ncategorize github stars ai, github stars manager tool, organize github bookmarks\n\u003c/sub\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famirhmoradi%2Fstarred","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famirhmoradi%2Fstarred","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famirhmoradi%2Fstarred/lists"}