@quill-io/sensor-github-stars
v0.2.1
Published
W2A sensor — watch a single GitHub repository and emit signals for every new star (with milestone tagging) and every new fork.
Maintainers
Readme
@quill-io/sensor-github-stars
W2A sensor that watches a single GitHub repository for new stars and emits one repo.star.gained signal per stargazer, with milestone tagging.
What it emits
repo.star.gained — fires once per new stargazer detected since the last poll.
event.summary example:
⭐ pohgggg (1.2k followers, Anthropic) starred machinepulse-ai/world2agent → 总数 47(前次 46, 距 50 还差 3) 🎉 跨过 25!Source
GitHub REST API:
GET /repos/{owner}/{repo}— totalstargazers_countGET /repos/{owner}/{repo}/stargazers(withAccept: application/vnd.github.v3.star+json) — paginated, includesstarred_atGET /users/{login}— full profile (only fetched when a token is configured)
Cursor
The sensor stores cursor_starred_at (ISO timestamp of the last emitted stargazer) and walks pages backwards from the last page on each poll until it finds the cursor — so it catches new stars even on busy repos and never re-emits past stars.
Install
In a Claude Code session with the @world2agent plugin:
/world2agent:sensor-add @quill-io/sensor-github-starsThis walks the Q&A in SETUP.md, writes the entry to ~/.world2agent/config.json, and generates a handler skill at ~/.claude/skills/quill-io-sensor-github-stars/SKILL.md.
Token note
A GitHub token is optional but raises the rate limit from 60 to 5000 requests/hour and lets the sensor pull each stargazer's full public profile — which makes the handler's "who is this person" judgement much sharper. No special scope needed; a default-permissioned PAT (or fine-grained token with Metadata: read) is enough.
