Skip to content

Add GitHub Star Shelf: searchable GitHub stars with plain-language AI explanations - #151

Open
start3208 wants to merge 5 commits into
MiniMax-AI:mainfrom
start3208:pr/github-star-shelf
Open

start3208 wants to merge 5 commits into
MiniMax-AI:mainfrom
start3208:pr/github-star-shelf

Conversation

@start3208

@start3208 start3208 commented Nov 19, 2026 •

Copy link
Copy Markdown

帮你总结 GitHub 项目收藏,帮你梳理、分类各个项目。GitHub star 了几十上百个项目,却不知道有什么用?这个插件一键帮你讲解项目,看懂项目有什么用。

界面:项目列表、收藏夹和 AI 讲解

暗色主题

What it does

GitHub Star Shelf turns your GitHub stars into a shelf you can search and ask about.

  • Import your stars through the GitHub CLI (gh), or any user's public stars by name. READMEs are cached in the background, so search can look inside them.
  • Collections and notes. File projects into collections, keep your own notes, or let the AI add them.
  • Search names, descriptions, topics, README text and notes (several words must all match). Filter by language, or by explained / noted; sort by star date, stars, last push or name.
  • Cloud explanation reads the project's metadata and README and explains it in plain language. No code is downloaded.
  • Local explanation shallow-clones the repository into the AI session's own workspace and explains what the code actually does. It never runs, installs or builds anything from the repository.
  • One session per project. Follow-ups stay with that project; a fresh session can be started at any time. Every permission request from the AI is shown in the page and waits for an answer.
  • Twelve MCP tools let the Agent list and search projects, manage collections, write notes and import stars.

The page is plain JavaScript with no build step; the Node side is start(context) returning { dispose }. The interface is in Chinese; the README is in English and 简体中文.

Install

Either import this repository in the marketplace (Create → Mini App → Import from Git repository, MiniMax Code 3.1.11 or later), or copy the folder — including the hidden .minimax-plugin — to <dataDir>/plugins/github-star-shelf/, normally ~/.minimax/plugins/github-star-shelf/, and restart. Then open GitHub 收藏夹.

git is required for local explanations. gh is optional but recommended: without it the app reads GitHub's public API anonymously, and a star import then shares the 60-requests-per-hour anonymous limit.

Tested environment and results

  • MiniMax Code 3.1.16 on macOS (Apple silicon), gh 2.96 logged in, Apple's git. Installed into ~/.minimax/plugins/github-star-shelf/ and opened in the desktop client.
  • MiniMax Code on Windows 11: the public package at commit 3e508ea (version 1.2.0) was imported with Import from Git repository and used against a real GitHub account: 50 stars imported while the README cache was still filling, search, the collections dropdown, a cloud explanation on MiniMax-M3.1-Flash (stopped and re-run from the page), a follow-up that ran two tools, the README tab, and the Agent calling list_collections / list_projects / get_project and reading back the right shelf. Local explanations through git, notes, the settings page and collection editing were used on the same machine too.
  • Import: read 50 stars with gh (0 added, 50 updated on the second run, so re-importing does not duplicate anything); READMEs cached for all 50.
  • Cloud explanation on morluto/rea: finished in 53 s, used only read-only gh api calls, cloned nothing.
  • Local explanation on Dakkshin/after-effects-mcp: finished in 57 s after a shallow clone of 520 KB into the AI session's cache folder.
  • Notes, follow-ups, collections, settings: written and read back; a permission card never appeared because the real Agent did not ask for one.
  • Git import preview in the marketplace recognised the package on macOS and Windows: name, version, commit, the declared permission (agentAccess: session.run) and the minimum version below.
  • npm run check in this repository: plugins/start3208/github-star-shelf: OK — 0 errors, 0 warnings; the 92 repository tests pass.
  • Package tests (npm test): 135 tests, 133 pass, 2 skipped by design (they need a real gh / git; opt in with SHELF_LIVE=1). CI runs Node 22 and 24 on Ubuntu, macOS and Windows; on Windows, 34 pass, 101 skip themselves (POSIX sh), 0 fail.
  • The page: rendered in headless Chrome against an isolated copy of the app with a fake gh, git and AI — light and dark, 360 to 1400 px wide, no console errors, no horizontal scrolling. The two screenshots above come from that run. It is not a real-browser test suite and that script is not in this package.

Not verified: on Windows 101 of the 135 tests skip themselves, because they fake gh and git through a POSIX sh — importing, explanation sessions, cloning, cancellation and rate limits. A Windows-only bug in that half would not be caught. Linux only ran in CI. The permission confirmation card was only exercised with a simulated Agent — the real one never asked for a permission on this machine. Whether "open session in sidebar" actually opens the sidebar cannot be seen from inside the page. GitHub Enterprise is not supported (GH_HOST is pinned to github.com).

Permissions and minimum client version

It declares agentAccess: ["session.run"] and nothing else: no session.read, no tool API, no microphone, camera or notifications, no Host navigation. engines.mcode is >=3.1.6, because the AI features need the session workspace folder; both READMEs name that version under ## Tested environment.

Notes for the reviewer

  • test/ and .github/ ship inside the package. The runtime payload is exactly miniapp/client and miniapp/node; everything else is documentation and offline tests. .github/workflows/ci.yml only runs in this package's own repository — nested workflows do not run here. Happy to drop either if you would rather keep packages bare.
  • gh, git and (on macOS) xcode-select are the only processes. Arguments are passed as arrays, never through a shell; GH_HOST is pinned to github.com; interactive prompts are disabled; all of them are stopped when the Mini App stops or is disposed.
  • Nothing is written outside context.dataDir and the AI session's own workspace folder, which is asked from the Host rather than guessed; only the folders this package created are ever deleted.
  • No credentials are read, stored or sent. gh keeps its own token; the app never touches it. The only network hosts are api.github.com, raw.githubusercontent.com and github.com — see ## Data & access in both READMEs.
  • The interface is in Chinese, the READMEs are English and 简体中文.

One row added to the MiniApp table in both root READMEs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant