RepositoryTypeScriptUSUnited States
armanckeser

armanckeser/stard

A card battle built from your GitHub stars. Every repo you've starred is a card: build a team and beat other developers, no signup. Also sorts your stars into GitHub Lists.

70stars
0forks
19issues
0views

Thành tựu nổi bật

Những danh hiệu mới nhất của dự án

1
TINIX TRENDING·Chủ đề: github-lists

#1 Repository Của Tuần

1
TINIX TRENDING·Chủ đề: electricsql

#1 Repository Của Tuần

1
TINIX TRENDING·Chủ đề: tanstack

#1 Repository Của Tuần

Stard

A card battle built from your GitHub stars

Every repo you've starred is a card. Build a team and beat other developers. No signup, free and open source.

Play with your username

A round of a run in the demo: cards bought from the shop go straight onto the board, two teams of creatures fight and the round is won, then the run finishes with 5 wins and 1 loss and shows the final team

Make your profile · npm · Agent API · Self-host

Here to organize your stars? Stard also sorts them into GitHub Lists and flags the dead ones. See the organizer

  • Type a GitHub username, no sign-in. The shop deals cards from that account's stars, shuffled afresh for every run.
  • Buy cards onto your Drafts shelf, drag them onto your half of the board, then press Fight. Every card acts at once.
  • Cards that share a language or topic make a set, ticked off like a pull request's checks. After rounds 2 and 4 you pick one of three boosts.
  • 5 wins finishes a run, 3 losses ends one.

Profile cards

octocat's top four repos on GitHub: astral-sh/uv, immich-app/immich, BurntSushi/ripgrep, sveltejs/svelte

Make yours

Put in any GitHub username, no sign-in. If you like Stard, a star helps others find the project.

Your stars say what you actually use, and nobody can see them. Stard turns them into something for your GitHub profile: your top four repos, short reviews in your own words, and your Lists, each drawn as a card.

1. Pick your top four. The four repos you would put on a poster. Every repo gets a poster in the colour of its language.

2. Review what you use. A rating out of five and a sentence or two. The card links to the repo.

A review card: BurntSushi/ripgrep, rated 4.5 of 5 by octocat, with two sentences on why

3. Show your Lists. Each GitHub List becomes a card, with the repos folded underneath. Archived and quiet repos are left out, so the list doesn't send people to dead projects.

A List card: Run your server, a list of 28 repos by octocat, with six posters

4. Copy the Markdown into your README. The cards are plain images served from a link, so there is nothing to install or keep running. Paste them into the README of the repo named after your username and they show on your GitHub profile.

Three ways to make one:

  • In the browser. Open the demo, type your username and press Load, arrange the sections, copy.
  • With your agent. npx skills add armanckeser/stard, then ask Claude Code or Codex to "make my Stard profile". The agent asks which repos are your favorites and why, and writes the README with you. The Profile screen has a copy-paste prompt for agents without skills.
  • On your own machine. npx github-stars-organizer runs the full app on localhost with your GitHub CLI login (gh auth login). Ratings and notes you already keep there become your reviews.

Getting started

Needs Node.js 20+ and the GitHub CLI logged in. Nothing to host:

npx github-stars-organizer

Option B: self-host with Docker

Needs Docker and a classic token with the repo scope, which is what lets Stard edit your Lists and unstar repos. Stard never reads or changes code; the key icon beside Import Stars shows which account and scopes the app is using. No clone:

GITHUB_TOKEN=ghp_... docker compose -f oci://ghcr.io/armanckeser/github-stars-organizer-stack:latest up -d

Open http://localhost:8080 and press Import Stars. That runs three containers (the app, Postgres and Electric); ghcr.io/armanckeser/github-stars-organizer:aio is all three in one, with its data under /data:

docker run -d -p 8080:8080 -v stars-data:/data -e GITHUB_TOKEN=ghp_... ghcr.io/armanckeser/github-stars-organizer:aio

The token can unstar repos and edit your Lists, so anyone who can reach the port can too. Set AUTH_PASSWORD to require a password, or sign in through your OIDC provider (Authentik, Authelia, Pocket ID...) with AUTH_ENABLED=1 and the OIDC_* settings in docker-compose.selfhost.yml. Or leave both unset behind a proxy that already checks who gets in.

From your server's app store: add the catalog once, then install Stard like any other app.

ServerWherePaste
CosmosMarket → Sources → Add Sourcehttps://armanckeser.github.io/selfhost-apps/servapps.json
CasaOS / ZimaOSApp Store → Add Sourcehttps://github.com/armanckeser/selfhost-apps/archive/refs/heads/casaos.zip
RuntipiSettings → App Stores → Add App Storehttps://github.com/armanckeser/selfhost-apps
PortainerSettings → App Templates → URLhttps://armanckeser.github.io/selfhost-apps/portainer/templates.json

Unraid's Community Apps doesn't list it yet; selfhost-apps has the template to add by hand.

Umbrel isn't listed: Umbrel installs take no settings, and Stard needs the token.

An AI agent can act through the same API as the UI (/api/*). With sign-in on, it sends Authorization: Bearer <AGENT_API_TOKEN>; set that yourself, or read the one generated on first start from the instance_secret table. AGENT-API.md lists the routes.

It also organizes the stars

Stard started as Stars Organizer, and everything from it is still here. I starred hundreds of repos over the years and could never find anything again. GitHub has Lists now, but sorting 500 stars into them one dropdown at a time is pretty much nobody's idea of a weekend, and a good chunk of what I had starred was dead anyway. Stard lets Claude Code or Codex do the sorting, writes the Lists back to GitHub, and gives every repo a health score so the abandoned ones stand out.

Opening a repo's health breakdown, rating it four stars and adding a note, opening the Homelab list, then the Explore dashboard

Compared with the alternatives

GitHub's stars pageAstralGithubStarsManagerStard
Organizes withLists, by handTags, by handIts own categories, sorted by an AI with your API keyGitHub Lists, sorted by the Claude Code or Codex you already use
Shows up on GitHubYesNo, tags live in AstralYes, Lists sync both waysYes, Lists sync both ways
Flags dead reposNoNoNoHealth score per repo, plus active alternatives for dead ones
Tags, notes, ratingsNoTags and notesTagsTags, notes and 1–5 ratings
ExtrasRule-based filtersSemantic search, release tracking, repo Q&AExplore charts of what you starred over time, backups before every launch
How you run itBuilt inHosted, or self-host (PHP)Desktop app or Dockernpx, or Docker

Based on each project's README and website as of November 2026. Coming from Astral? Stard imports Astral's export: tags become Lists and notes carry over.

What's inside

ListsYour GitHub Lists, plus a "Not in any list" pile to sort. Every change syncs back to GitHub.
Health score0 to 10 from last commit, closed vs open issues, contributors, star growth and last release. Archived repos score 0.
Similar reposFor any star, and active alternatives for the ones nobody maintains anymore.
Tags, ratings, notesOn top of your stars, searchable and filterable.
ExploreCharts of your stars by language, health and last commit, and what kinds of repos you starred over time.
ProfileYour top four, your reviews and your Lists as cards for a GitHub README, with archived and quiet repos left out. Copy or download the Markdown.
PlayA run in the browser: buy cards drawn from your stars, place them on a board, build sets and pick boosts, and fight other teams, until 5 wins or 3 losses. Play one.
BattleTwo GitHub usernames, and each one's team of four (an ace they pick and three drawn from their stars each day) fights as trading cards in an arena: level from stars, HP from contributors, attack from commits, type from the language. A repo you own is shiny. Build a character on the Profile screen (a figure, a class with a perk, a motto), paste its card into your README, and the game reads your character from there. From your own copy you can challenge someone to a real match: turn by turn, over hours or days, with a GitHub Discussion on your profile repo as the whole record. Every move is a comment, the dice are public, and nothing is stored anywhere else. Try one. The plan for the full game, played in GitHub Discussions, is in #45.
AI sortingClaude Code, Codex or any agent that can run curl reads your stars, suggests Lists and sorts repos into them once you agree. The robot icon beside Import Stars gives you the prompt, or install the skill with npx skills add armanckeser/stard. AGENT-API.md has the API.
Search for your agentnpx github-stars-organizer search pdf parser lists the stars that match, with their Lists and whether each is still alive. To have Claude Code or Codex check your stars before suggesting a library or tool, add this line to your CLAUDE.md or AGENTS.md: "Before you suggest a library, tool or GitHub repo, run npx github-stars-organizer search <a few words> to check what I already starred. If my pick is quiet or hasn't released in a year, say so and name the current alternative."
BackupsA backup before every launch, and a restore that only adds back what's missing.
PrivateYour token never leaves your machine. No telemetry. Matches, team links and README cards use stard.armanckeser.com.

A List called Run Your Server: 27 repos with language, stars, a health score per repo and topics
Lists. The same table inside a List, with a health score on every repo.

Is this for you?

Yes, if you have a few hundred stars you never look at, you already use (or want to use) GitHub Lists, or you want to know which of your stars quietly died.

Not yet, if you want semantic search over READMEs or release notifications (GithubStarsManager does both), or a hosted site you sign into (Astral has one).

Contributing

CONTRIBUTING.md has the dev setup.

Copyright (C) 2026 Armanc Keser. AGPL-3.0-or-later, with absolutely no warranty. Not affiliated with or endorsed by GitHub. Privacy · Don't want to be played?

Similar Projects

Discover other similar projects and AI models.

RepositoryTypeScript
AmintaCCCP/GithubStarsManager

AI-powered GitHub stars manager with semantic search, auto-categorization, and release tracking

3.9k
Nov 18, 2026
RepositoryTypeScript
n8n-io/n8n

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

211.6k
Nov 21, 2026
RepositoryJavaScript
louislam/uptime-kuma

A fancy self-hosted monitoring tool

94.8k
Nov 22, 2026
RepositoryPython
521xueweihan/HelloGitHub

:octocat: 分享 GitHub 上有趣、入门级的开源项目。Share interesting, entry-level open source projects on GitHub.

190.6k
Oct 31, 2026
RepositoryTypeScript
appwrite/appwrite

The open-source cloud for agents & devs. Including Auth, Databases, Storage, Functions, Messaging, Hosting, Realtime, WAF and more

58.5k
Nov 21, 2026
RepositoryTypeScript
Dokploy/dokploy

Open Source Alternative to Vercel, Netlify and Heroku.

38.6k
Nov 21, 2026
RepositoryTypeScript
nanocoai/nanoclaw

Your own always-on AI assistant: self-hosted, open source, lightweight. Each agent runs in its own container on your machine, on the harness you choose (Claude Code, Codex, Cursor, OpenCode). Talk to it from Slack, WhatsApp, Telegram, Discord and more.

31.1k
Nov 21, 2026
RepositoryTypeScript
karakeep-app/karakeep

A self-hostable bookmark-everything app (links, notes and images) with AI-based automatic tagging and full text search

30.7k
Nov 15, 2026
RepositoryTypeScript
linkwarden/linkwarden

⚡️⚡️⚡️ Self-hosted collaborative bookmark manager to collect, read, annotate, and fully preserve what matters, all in one place.

20.5k
Nov 18, 2026