Changelog
What has shipped in shelf, newest first. Releases are on GitHub and npm (@limyuquan/shelf).
0.5.0
The first public release: binaries for macOS, Linux and Windows, and the npm package. Everything below is in it.
Fixes
shelf due <name> -7dworks without--; usage errors exit 2 with or without--json.shelf lintreports skills that fail to load and invalid directory names, and exits 1.shelf renewcounts from today, like renew on use, so renewing twice no longer adds up towardsmaxLoanDays.shelf newandshelf addvalidate before writing anything, and refuse archived skills' names.shelf uion a port in use is aCONFLICTwith a hint instead of an internal error.- Dashboard: the Overdue row says why a loan is still there; "Return and delete edits" asks first; paths under your home directory show as
~/…; long diff lines wrap.
Since the 0.4 milestone
shelf insights: tokens each project loads at session start, and which skills agents used in the last 30 days.- Actor detection: Codex, and any harness that sets
AI_AGENT, are recorded as the acting agent. - Agents may keep loans, limited by the guide to skills covering a project's direct dependencies, with a
--reason. - Dashboard bulk actions: renew, update, keep or return several loans at once.
- Dashboard port: a second
shelf uion a port in use fails instead of sharing it. - Writing skills:
shelf newplusrename,duplicate,archiveandlint; the dashboard gets a lint strip above the SKILL.md editor. - Sets:
shelf set save/list/deleteandshelf borrow @set. - Live updates in the dashboard as agents and the CLI work.
- Search inside skills:
shelf search, the Library filter and ⌘K look in SKILL.md and reference files. - Suggestions:
shelf suggestand project pages match library skills to a project's dependencies and files. - Keep and loan length:
shelf keepfor loans that never expire (recorded in the lockfile), andshelf loan-daysfor per-skill loan lengths. - Find existing skills in the dashboard: scan and adopt with checkboxes.
- Revision history: view any revision, compare two, and
shelf restore. - Insights page in the dashboard: context budget and skill usage.
- Dashboard rebuilt as a React app over a typed API, with borrow, promote, pull, a file editor, settings, keyboard navigation and a mobile layout. Remote access stays outside shelf: the server listens on 127.0.0.1 only.
- Renew on use:
shelf setupinstalls Claude Code and Codex hooks that renew a loan when its skill is used and report loans needing attention at session start. shelf statusno longer suggestsshelf initto agents in projects that don't use shelf.
0.4 milestone
shelf addandshelf pull: import skills from git or a directory after a local audit, and update them later.shelf audit.- Link mode (
--link,"mode": "link"). - Project targets (
shelf targets) for harnesses beyond.agents/skillsand.claude/skills. - Release builds for macOS, Linux and Windows, and npm packages.
0.3 milestone
- The first local dashboard,
shelf ui.
0.2 milestone
shelf scanandshelf adoptfor existing skill copies.shelf log,shelf diff,shelf propagate,shelf sweepandshelf doctor.
0.1 milestone
- The library, content-addressed revisions, loans with due dates, the lockfile,
shelf statusandshelf sync.