@scrapes/installer

One guided CLI to install, update, and manage Agentic OS and Skill Systems. It detects what you already have, asks only for what's missing, and hands off to each product's own setup — so you get one friendly front door without anything reinventing the real installers underneath.

Quick start

npx @scrapes/installer

That opens the menu. Pick what you want to do — no flags, no config.

Windows: run it in PowerShell (not Git Bash). The menu needs an interactive terminal. You still need Git installed — the installer finds Git Bash on its own when a setup script needs it.

What it does

The menu is intent-first. It only shows what makes sense for your current state:

• Install a skill system — shows the catalog, pick one or all, installs into the current folder.
• Update skill systems — re-checks each installed system and updates what changed (silent on what's already current).
• Add or remove skill systems — manage what's installed in a folder.
• Install Agentic OS — set up the full Agentic OS environment. On a fresh install you pick which optional skills to keep (core skills are always installed); keeping everything is one keypress.
• Update Agentic OS — refresh an existing Agentic OS install.
• Install a single skill — install one or more of Agentic OS's own skills on demand, into a detected Agentic OS install, globally (~/.claude/skills), or any folder (.claude/skills/ is created when absent). Skills that only work fully inside the Agentic OS warn before installing elsewhere — you can still proceed.

Everything is covered here — you never need to call the underlying tools by hand.

Requirements

• Node.js 18+ and npm 9+ (npx ships with npm).
• Git — required for Agentic OS, and for the per-system setup scripts on Windows. Auto-detected wherever it's installed.
• A Scrapes token for the private packages (the installer prompts you — see below).

Access & tokens

The installer probes for access first and only prompts when it has to:

• Skill Systems uses an npm token for the private @scrapes scope.
• Agentic OS uses a GitHub token.

It asks for the right one per product, once, and remembers it (OS keychain + your npm config). On every run it re-validates the saved token against the registry — if it expired (npm tokens rotate ~monthly), it tells you and asks for a fresh one instead of failing silently. Grab tokens from the Scrapes classroom.

How it works

The installer is a router, not a reimplementation. Each product is an adapter behind a uniform contract; the installer detects state, resolves access, then closes its own UI and hands off to the real tool with a live terminal:

• Skill Systems → @scrapes/skill-systems (validates versions, protects your edits, merges config).
• Agentic OS → its git-based clone/update routine.

Because it always hands off to @latest, you pick up new skill-system releases without the installer itself needing an update.

Flags

The default command is the interactive wizard. For finer control:

npx @scrapes/installer --dry-run        # show what it would do, install nothing
npx @scrapes/installer --dir <path>     # target a specific folder (default: current dir)

Real install/update is the default; --dry-run is opt-in.

Troubleshooting

• The menu won't open / "Something went wrong" (Windows) — you're in Git Bash. Use PowerShell.
• 404 Not found / you do not have permission on @scrapes/skill-systems — your npm token expired. Re-run the installer and paste a fresh token from the classroom when prompted.
• bash executable not found (Windows) — install Git for Windows.