Download: grab the latest signed & notarized
reshelf-<version>.dmg from Releases
— universal (Apple Silicon + Intel), macOS 14+. Drag to Applications and run; no
Gatekeeper warnings. Or build from source (below).
The menu bar and Dock show the name reshelf; the Xcode project/module keeps the
legacy name OpenSourceShelf.
What it does
- Capture fast — copy a GitHub link and press ⌘V anywhere in the window (or
paste into ⌘K / ⌘N); reshelf fetches the metadata and auto-categorizes it
(Database, AI / Agent, macOS, …) — no AI required. Already have it? You get an
"Already on your shelf" card, and Return jumps to it.
- Capture Assist (optional, fully on-device) — on Macs with Apple Intelligence,
each capture can auto-fill use cases, a note, and tags right after you save,
and a one-click backfill fills entries that have none. No setup, no API keys,
nothing leaves your Mac — and it never overwrites anything you typed.
(Settings → Capture → Capture Assist.)
- Organize onto shelves — Top Shelf (keepers), The Collector (default),
Yard Sale (not sure / let go). Move with one keystroke (⌘T / ⌘Y).
- Browse by anything — sidebar filters by shelf, live category list, folders,
tags (most used or recently added — your pick in Settings), or Cloned. Every
sidebar section folds away with a click on its heading. Sort by Recently Added / Name / Most Stars / Last Updated.
- Folders for what you got them for — clone thirty repos for one project and group
them: right-click → Folder. Folders are yours to name, sit in their own
sidebar section, and are separate from categories (what a repo is) and shelves (how
much you value it). Deleting a folder only ungroups — nothing else changes.
- Batch actions — ⌘-click rows (or ⇧-click a range), then move them all to a
shelf, add them all to a folder, or remove their clones in one go. The whole point of
folders: retire a project's worth of repos together instead of one at a time.
- Clone locally, organized — full clones grouped by category at
~/reshelf/repos/<Category>/<repo>, so you can point an AI agent at one category.
Works without git-lfs. Cloning uses git from Apple's Command Line Tools; if
they're missing, run xcode-select --install in Terminal once.
- Update checks — a read-only
git ls-remote tells you which clones are behind;
one-click Pull, Check Clones for Updates (⌘⇧U) to sweep them all, or
right-click a folder → Pull Repos to update just that project's clones.
- See what fits your own projects (new in 1.17) — press the + next to
My Repos and tick your GitHub repos. Click one and the list shows the repos on
your shelf that really fit it, best first, with a one-line Why it fits written
on your Mac by Apple Intelligence. It runs only when you ask (adding a repo,
New Fits, Analyze All Fits), never in the background. Settings → Fits
sets how many fits, same language only, recently updated, and hiding GPL / AGPL or
archived repos.
- Reshelfed — when an agent borrows code from a shelf repo for one of your
projects, the reshelf skill thanks the author in that project's
ACKNOWLEDGEMENTS.md and the inspector shows "Reshelfed in ". The
Reshelfed row in the sidebar counts them.
- The UI mark and a Language filter — mark the repos whose UI you like
(right-click, the brush), and filter any list by language or UI Only, next to
Sort.
- A tidy right-click menu — the three shelves and the UI mark as icons on top,
then Folder, your clone, and Remove from Catalog last.
- Understand licenses — an ⓘ next to any license explains in plain language what
you can and must do, with an optional caution for copyleft / source-available ones.
- No duplicates — capture detects a repo that's already in your catalog;
Remove Duplicate Repos cleans up any you already have.
- Hard to lose data — an isolated store plus automatic JSON backups (last 30),
auto-restore-on-empty, manual restore, and JSON import/export.
- Updates itself — Check for Updates (or a quiet automatic check) fetches
signed releases through Sparkle, so you never hunt for a DMG again. Every update is
EdDSA-signed and notarized; you can turn automatic checks off in Settings.
AI, when it happens, happens on your Mac. Capture Assist fills in use cases, a
note and tags with on-device Apple Intelligence — no key, no setup, nothing sent
anywhere. There is no provider to choose and no cloud option to turn on.
In one minute
- Build and run (see below) — you get a sidebar, project list, and inspector.
- Press ⌘K, paste a GitHub URL → Quick Capture opens with everything fetched →
Enter to fetch, Enter again to save (no mouse needed).
- Sort it onto a shelf (⌘T Top Shelf, ⌘Y Yard Sale), or filter the sidebar by
category, folder, or Cloned.
- Right-click a repo → Clone Repository. The inspector shows up to date vs
updates available with a one-click Pull.
Tip: drag the sidebar/inspector dividers to resize, and in Settings show/hide and
drag-reorder the inspector sections.
How you run it
Download (no Xcode) — grab the latest reshelf-<version>.dmg from
Releases, open it, and drag
reshelf to Applications. It's signed & notarized, so it just opens.
To build it yourself:
Xcode
- Open
OpenSourceShelf.xcodeproj.
- Select scheme OpenSource Shelf (the scheme/target keep the legacy name; the
built app is
reshelf.app via PRODUCT_NAME).
- Run (⌘R).
Terminal
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗