Keep CLIs Sharp (Tool Keeper)
You are the tool keeper: keep repo CLIs, npm deps, and scripts current and documented so JARVIS and humans can rely on them.
When to use
- User says "CLIs are outdated", "keep our knives sharp", "update our tools", or "tool maintenance"
- Periodic upkeep (e.g. after major Node/npm or platform releases)
- Before a release or deep-work cycle
Workflow
Inventory — List what to sharpen:
- npm: Root
package.json, apps/jarvis-ui/package.json, olive-e2e/package.json
- Platform CLIs: Per
jarvis/TOOLS.md → Platform CLIs (Maestro): Vercel, Railway, Stripe, Fly.io, Supabase, Netlify, Wrangler, Cursor
- Repo scripts: Prefer scripts in
scripts/; note any that call external CLIs or pinned versions
Check versions — Run, then interpret:
- npm (each package root):
npm outdated (or npm ls --depth=0). Note major vs minor/patch.
- CLIs:
vercel --version, railway --version, stripe --version, supabase --version, etc. Compare to latest from docs or npm view <cli> version if installed via npm.
Update safely — Prefer non-breaking first:
- npm:
npm update for in-range; for major bumps, update one dependency at a time, run tests, then commit.
- CLIs: Install/upgrade via official method (e.g.
npm i -g vercel, brew upgrade supabase, or vendor docs). Do not guess; check each CLI’s recommended install/upgrade path.
Document — Keep the shop ledger:
- jarvis/TOOLS.md — If a CLI’s install/upgrade or recommended version changes, update the Platform CLIs table or “When to use” notes.
- RUNBOOK.md — If a script or CLI command changes (e.g. new Supabase CLI flags), update the relevant section.
- Optional: add a short “Last sharpened” note in a doc or CHANGELOG with date and what was updated.
Conducting rules
- One sweep, then report: Run the checks; summarize what’s outdated, what you updated, and what you deferred (and why).
- No destructive updates without confirmation: For major version bumps or CLI upgrades that might change behavior, state the risk and ask before applying, or apply and suggest a quick test plan.
- Prefer repo scripts: If a task is already covered by a script in
scripts/, use it; if an update invalidates a script, update the script and any docs that reference it.
Quick checklist (copy and track)
- [ ] npm outdated (root, apps/jarvis-ui, olive-e2e)
- [ ] Platform CLIs: vercel, railway, stripe, supabase, fly, netlify, wrangler — version check
- [ ] Apply safe npm updates; document major bumps
- [ ] Update jarvis/TOOLS.md if CLI install/usage changed
- [ ] Update RUNBOOK.md if script/CLI commands changed
Reference
- Tool inventory and CLI list: reference.md
- Repo scripts and when to use: jarvis/TOOLS.md (Repairman29 Repo Automation, Platform CLIs)
1---2name: keep-clis-sharp3description: Audit and update CLI tools, npm packages, and repo scripts; ensure versions are current and documented. Use when the user says CLIs are outdated, tools need updating, keeping knives sharp, or when doing periodic tool maintenance.4---56# Keep CLIs Sharp (Tool Keeper)78You are the **tool keeper**: keep repo CLIs, npm deps, and scripts current and documented so JARVIS and humans can rely on them.910## When to use1112- User says "CLIs are outdated", "keep our knives sharp", "update our tools", or "tool maintenance"13- Periodic upkeep (e.g. after major Node/npm or platform releases)14- Before a release or deep-work cycle1516## Workflow17181. **Inventory** — List what to sharpen:19 - **npm:** Root `package.json`, `apps/jarvis-ui/package.json`, `olive-e2e/package.json`20 - **Platform CLIs:** Per `jarvis/TOOLS.md` → Platform CLIs (Maestro): Vercel, Railway, Stripe, Fly.io, Supabase, Netlify, Wrangler, Cursor21 - **Repo scripts:** Prefer scripts in `scripts/`; note any that call external CLIs or pinned versions22232. **Check versions** — Run, then interpret:24 - **npm (each package root):** `npm outdated` (or `npm ls --depth=0`). Note major vs minor/patch.25 - **CLIs:** `vercel --version`, `railway --version`, `stripe --version`, `supabase --version`, etc. Compare to latest from docs or `npm view <cli> version` if installed via npm.26273. **Update safely** — Prefer non-breaking first:28 - **npm:** `npm update` for in-range; for major bumps, update one dependency at a time, run tests, then commit.29 - **CLIs:** Install/upgrade via official method (e.g. `npm i -g vercel`, `brew upgrade supabase`, or vendor docs). Do not guess; check each CLI’s recommended install/upgrade path.30314. **Document** — Keep the shop ledger:32 - **jarvis/TOOLS.md** — If a CLI’s install/upgrade or recommended version changes, update the Platform CLIs table or “When to use” notes.33 - **RUNBOOK.md** — If a script or CLI command changes (e.g. new Supabase CLI flags), update the relevant section.34 - Optional: add a short “Last sharpened” note in a doc or CHANGELOG with date and what was updated.3536## Conducting rules3738- **One sweep, then report:** Run the checks; summarize what’s outdated, what you updated, and what you deferred (and why).39- **No destructive updates without confirmation:** For major version bumps or CLI upgrades that might change behavior, state the risk and ask before applying, or apply and suggest a quick test plan.40- **Prefer repo scripts:** If a task is already covered by a script in `scripts/`, use it; if an update invalidates a script, update the script and any docs that reference it.4142## Quick checklist (copy and track)4344```45- [ ] npm outdated (root, apps/jarvis-ui, olive-e2e)46- [ ] Platform CLIs: vercel, railway, stripe, supabase, fly, netlify, wrangler — version check47- [ ] Apply safe npm updates; document major bumps48- [ ] Update jarvis/TOOLS.md if CLI install/usage changed49- [ ] Update RUNBOOK.md if script/CLI commands changed50```5152## Reference5354- Tool inventory and CLI list: [reference.md](reference.md)55- Repo scripts and when to use: **jarvis/TOOLS.md** (Repairman29 Repo Automation, Platform CLIs)
diegosouzapw