0.2.0-beta.14

RepoMagpie 0.2.0-beta.14

The fifteenth pre-release: Discover. Search GitHub from the CLI or the app by words, concern and kind, see which repositories you already have a note on, and add the ones you choose to your inbox. New notes from GitHub get a better kind and better suggested domains, and a wrong suggested domain goes in one click, with Undo.

Install or upgrade

You need Node.js 22.12 or later.

npm install -g repomagpie@beta
repomagpie --version
repomagpie setup

repomagpie --version prints 0.2.0-beta.14. Your notes need no changes.

Run repomagpie setup after the upgrade, so your agents get the new skill. It has one new paragraph: for "find me a … library", the agent runs repomagpie discover --json, shows a few results and adds one only when you pick it. Until you run setup, repomagpie doctor reports a skill older than the CLI.

Set GITHUB_TOKEN if you search often. Without a token, GitHub allows 10 searches a minute, counted for your public IP address and shared with everything else that uses it. A token gives you 30 of your own. export GITHUB_TOKEN=$(gh auth token) (in PowerShell, $env:GITHUB_TOKEN = gh auth token).

Added

• Discover in the CLI. Search GitHub's repositories and see, for each one, its stars, forks, last push, licence, an estimated kind and domains, and whether a journal already has a note on it, with your Verdict, or "What it does" when it has no Verdict.

  repomagpie discover "pdf invoice" --domain api --language TypeScript
  repomagpie discover --domain styling --kind library --min-stars 1000
  repomagpie note https://github.com/<owner>/<repo>

  • Filters: --domain, --kind, --topic, --language, --min-stars (10 by default), --updated-within (2 years by default), --include-archived, --sort, --limit, --page. --json for your agent.
  • A domain searches its 3 most common GitHub topics, one request each, since GitHub's search can't combine topics with OR. Without a token it searches 2 and names the one left out.
  • A kind that only a repository's files can tell, such as library or cli, is chosen from the estimates, so that filter is approximate and says so.
  • Rate limits: a limit that ends within a minute is waited out once, and the CLI says so. If GitHub stops a search partway, you get the results it found, with a warning. A wait is said in seconds, or as a time that hasn't passed yet.
  • The same search within 10 minutes is answered from a cache in your personal journal, and says so.
  • REPOMAGPIE_DEBUG_HTTP=1 prints each GitHub request's status and rate-limit headers on stderr, never a token, if you need to see why GitHub limits a search.

• Discover in the app. repomagpie ui has a Discover page under Add: the same search with filters, result cards, "Add to inbox", "Add with a Verdict…", and several at once with "Add N to inbox", which says what was added, what was there already and what failed. Without a token it asks before adding more than 5.

• Remove a suggested domain in the app. The × beside a suggested domain's check takes that suggestion out of the note and changes nothing else. The toast offers Undo for 10 seconds, which puts it back where it was. repomagpie domains --suggest doesn't bring a removed suggestion back.

Changed

• Better kind and domains for a new note from GitHub. RepoMagpie now also reads the start of the README, the keywords in package.json, pyproject.toml or Cargo.toml, and whether the repository is a GitHub Action. On 69 public repositories, the kind is right for 24 instead of 21, and 51 of 60 expected domains are suggested instead of 49, with no more wrong ones. A profiling topic no longer suggests performance. A README without a description also gives the "What it does" draft. Notes you already have don't change.

Privacy

Discover is a new network request: GET https://api.github.com/search/repositories, with your search words and filters, and GITHUB_TOKEN when it is set. It runs only when you search. Nothing from your journals is sent. In the app, the local server makes the request, never the browser. The MCP server stays offline: it has no Discover tool. SECURITY.md lists it.

Docs

• Decision 0045 (Discover: where it runs, the requests, the cache, rate limits) and 0046 (the README, manifest keywords and the Action file as classification signals, with the eval's numbers).
• npm run eval:classification: the kind and domains of 69 public repositories, expectations written by hand before the code ran.

The full list is in the changelog.

Known limits

• Without a token, a domain search leaves out its third topic, and other programs or devices on your network can use up the 10 searches a minute before RepoMagpie sends one.
• Discover sees what GitHub's search sees: names, descriptions and topics, not READMEs. Its estimated kind can differ from what repomagpie note decides once it reads the repository.
• The kind is still right for only about a third of the 69 repositories in the eval; it's a candidate follow-up.
• The retrieval numbers come from synthetic fixtures, and how well agents map questions onto domains isn't measured yet (evals/skill/ is ready but not run).
• The graph's cold first open on 2,000 notes takes about 2 s, sometimes a little over its 2 s target. A warm open is within it.
• The Stop reminder is for Claude Code only. It reminds the agent; it doesn't make it offer.
• Nothing empties the trash. Delete a file in .trash/ to remove it for good, or move it back to notes/ without its stamp to restore it.
• On Windows, Codex CLI, Copilot CLI, Gemini CLI and Cursor start every hook through Windows PowerShell, which adds about 255 ms to each shell command.
• In Codex CLI, Cursor and Copilot CLI, an agent that retries on its own without asking you gets through on the second try. The hook tells it not to, and you see a line saying what happened.
• An entry names one Node.js and one install. After switching Node.js versions, run repomagpie doctor, then repomagpie setup again.