Skip to content

LeifDiao/github-pick

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

3 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

GitHub Pick

Clone it, open any AI agent inside the folder, and just say "curate the top GitHub projects on X." You get a localized, double-click-to-open research board โ€” the agent searches GitHub broadly, judges each project's real-world reception, tags it, and writes a localized digest. Zero build, zero API key, nothing to install. The repo is the workspace.

๐ŸŒ ไธญๆ–‡็‰ˆ ยท ๐Ÿ–ฅ Live page ยท โš–๏ธ License

ไธญๆ–‡็ฎ€ไป‹๏ผš Clone ไธ‹ๆฅ๏ผŒๅœจ้กน็›ฎๆ–‡ไปถๅคน้‡Œๆ‰“ๅผ€ไปปๆ„ไธ€ไธช AI๏ผŒ็›ดๆŽฅ่ฏดไธ€ๅฅใ€Œๅธฎๆˆ‘่šๅˆ X ไธป้ข˜็š„ๅผ€ๆบ้กน็›ฎใ€๏ผŒๅฐฑ่ƒฝๅพ—ๅˆฐไธ€ไธชๆœฌๅœฐๅŒ–ใ€ๅŒๅ‡ปๅณๅผ€็š„ๅผ€ๆบ็ ”็ฉถ็œ‹ๆฟใ€‚AI ๅนฟๆœ GitHubใ€ๅˆคๆ–ญๆฏไธช้กน็›ฎ็š„็œŸๅฎžๅๅ“ใ€ๆ‰“ๆ ‡็ญพใ€ๅ†™ๆœฌๅœฐๅŒ–็‚น่ฏ„๏ผŒไธ€ไธช้›ถๆž„ๅปบ็š„้™ๆ€็œ‹ๆฟ่ดŸ่ดฃๅฑ•็คบใ€‚ๅฎŒๆ•ดไธญๆ–‡ๆ–‡ๆกฃ โ†’ README_zh.md


GitHub Pick turns "I want to learn the open-source landscape of X" into a clean, scannable dashboard. You give a topic; the AI searches GitHub broadly, judges each project's real-world reception, tags it, and writes a localized digest. A zero-build static dashboard (index.html + data.js) renders it โ€” double-click, no server, no build step.

It is not a plugin and not a skill you install anywhere. It is just a project folder with an instruction file (AGENTS.md / CLAUDE.md) that any modern AI coding agent reads automatically. The repo is the workspace.


How it works in one picture

clone repo  โ”€โ”€โ–ถ  open an AI agent in the folder  โ”€โ”€โ–ถ  "ๅธฎๆˆ‘่šๅˆ X ไธป้ข˜็š„ๅผ€ๆบ้กน็›ฎ"
                                                              โ”‚
        AI reads AGENTS.md + workflow/github-pick.md โ—€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                                              โ”‚
        searches GitHub ยท tags ยท writes sessions/*.json โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
                                                              โ”‚
        runs `node scripts/build-data.mjs` โ†’ data.js โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ถ  open index.html โœฆ

No installation. No API key. No global config. Everything lives in the cloned folder.


Requirements

  • An AI coding agent that reads AGENTS.md or CLAUDE.md โ€” e.g. Claude Code, Codex CLI, Cursor, Cline, Aider.
  • Node.js (any recent version) โ€” for the tiny zero-dependency build script.
  • gh CLI (optional) โ€” if installed and authenticated, GitHub search gets 5000 req/hr instead of the anonymous 60/hr. Either works for a single run.

Quick start

git clone https://github.com/LeifDiao/github-pick.git
cd github-pick
# open your AI agent IN this folder, then just talk:
#   "ๅธฎๆˆ‘่šๅˆ RAG ๆก†ๆžถ ็š„ๅผ€ๆบ้กน็›ฎ"
#   "curate the top Claude Code skill projects"

The first time you run it, the agent asks which language you want. After that the choice is locked (see below) and it never asks again. When it finishes, open index.html.

Prefer to set things up by hand first? Just edit config.json ("lang": "en") and run node scripts/build-data.mjs.

Language โ€” pick once, stay forever

One language per project, chosen on first run, stored in config.json. From then on everything โ€” every digest and the dashboard UI โ€” stays in that language. There is no runtime toggle.

  • zh and en ship with built-in dashboard UI labels.
  • Any other language (ja, es, fr, โ€ฆ) works too: the agent translates the UI labels into config.json the first time.
  • To change later: edit config.json and re-run node scripts/build-data.mjs. (Existing sessions keep the language they were written in; new ones use the new language.)

The dashboard

  • Double-click index.html โ€” opens via file://, no server.
  • Sessions are listed in the sidebar; projects are grouped into categories with tags.
  • Per-card buttons mark a project studied or hidden (stored in your browser's localStorage, so your progress is private and local).

Tag legend

Tag Meaning
๐Ÿ”ฅ Trending right now (recent momentum, discussion, integrations)
๐Ÿ†• Created recently
๐Ÿ† Top-tier โ€” what leading practitioners actually use
๐Ÿ“œ Still works, but has clearer successors / slowing maintenance

Tags are language-agnostic: the emoji is the stable key, only the label is translated.


Project structure

github-pick/
โ”œโ”€โ”€ AGENTS.md                 # entry point any agent reads (Codex/Cursor/Cline/Aiderโ€ฆ)
โ”œโ”€โ”€ CLAUDE.md                 # makes Claude Code read AGENTS.md
โ”œโ”€โ”€ workflow/github-pick.md   # canonical, agent-neutral workflow spec (source of truth)
โ”œโ”€โ”€ config.json               # { lang, ui } โ€” the one-time language choice
โ”œโ”€โ”€ index.html                # the dashboard (double-click to open)
โ”œโ”€โ”€ data.js                   # generated โ€” do not hand-edit
โ”œโ”€โ”€ scripts/build-data.mjs    # zero-dependency: sessions/*.json + config โ†’ data.js
โ”œโ”€โ”€ sessions/                 # one <date>-<slug>.json (+ .md) per topic run
โ””โ”€โ”€ LICENSE

How the data flows

sessions/*.json (one per topic, written by the agent) โ†’ node scripts/build-data.mjs inlines config.json + all sessions into โ†’ data.js โ†’ index.html reads it. The build script is the only thing that writes data.js; agents never hand-edit it.

Works with any agent

The "brain" is a plain spec (workflow/github-pick.md) that any capable agent can follow. Agents differ only in how they dispatch the work โ€” one that can spawn parallel subagents (e.g. Claude Code) fans the category reviews out for speed; a single-thread agent (e.g. Codex) runs them sequentially. The output is identical either way.

Contributing

Issues and PRs welcome โ€” see CONTRIBUTING.md. The workflow logic is centralized in workflow/github-pick.md; change behavior there. Keep data.js out of manual edits; regenerate it with the build script.

License

MIT

About

Say "curate the top GitHub projects on X" to any AI agent โ†’ a localized, double-click research board. Reception-based judgment, ๐Ÿ”ฅ๐Ÿ†•๐Ÿ†๐Ÿ“œ tags, zero build, no API key.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors