shed-cli
v0.1.1
Published
Shed — keep agent & CLI tools current (detect + update)
Maintainers
Readme
Shed
A calm place to keep agent & CLI tools current.
Mac app: Download · Site: useshed.vercel.app · CLI: npx shed-cli
Brand: olive / cream / charcoal (assets/shed-icon.png). npm package is shed-cli (the name shed is taken); the binary is still shed.
Not on the Mac App Store — Shed must run brew/npm/agent update commands outside Apple’s sandbox. GitHub Releases is the storefront.
Install
Menu bar (macOS 14+)
- Download
Shed-*-macos-arm64.zipfrom Releases - Move
Shed.app→/Applications - Right-click → Open, or
xattr -cr /Applications/Shed.app && open -a Shed - Requires Node.js 20+ on your
PATH
CLI
npx shed-cli status
npx shed-cli check
npx shed-cli updateFrom this repo:
npm install && npm run build
node dist/shed.js status
npm run app # native menu bar + embedded CLICommands
shed status | check | probe <id> | update | catalog | discover
shed add <id…> | remove <id> | export [--clipboard] | import <file>
shed schedule install --days 3 | activity | helpDocs (start here if you’re new)
| Doc | What’s in it |
| ---------------------------------------------- | ------------------------------ |
| docs/PRODUCT.md | What Shed is, how to use it |
| docs/ARCHITECTURE.md | CLI + app + data flow |
| docs/CONTRIBUTING.md | Dev setup, branches, PR norms |
| docs/DISTRIBUTION.md | Release zip, npm, notarization |
| RELEASE.md | 0.1 ship checklist / branching |
Layout
bin/shed.ts CLI source
dist/shed.js bundled CLI (npx + embedded in app)
src/lib/ engine
catalog/tools.json curated tools
macos/Shed/ SwiftUI / AppKit menu bar app
site/ marketing (Vercel)
assets/ brand + menubar template PDF
~/.shed/ your config + activity (local only)Config
Tracked tools live in ~/.shed/config.json. Each tool needs id + update; optional detect / latest / github / policy. Onboarding never silently adds tools.
