robot-resources — Unified Installer

One command to install all Robot Resources tools:

npx robot-resources

What the wizard does

1. GitHub OAuth — authenticates via PKCE, saves API key to ~/.robot-resources/config.json
2. Router install — detects Python 3.10+, creates venv, pip installs robot-resources-router
3. Service registration — registers router as launchd (macOS) or systemd (Linux) service
4. MCP auto-config — detects Claude Desktop and Cursor, injects scraper MCP entry

Adding a new tool

When you build a new product for RR, follow this checklist:

1. Create the npx entry point

Your tool needs an npm package with a bin entry that runs a setup wizard. Two patterns:

• Node.js tool: Add bin to your package.json pointing to a setup script
• Python tool: Create a thin npm wrapper (like router/packages/router/) that handles pip install

The wizard should:

• Check ~/.robot-resources/config.json — offer login if missing
• Install the tool
• Configure MCP if applicable
• Print usage instructions

2. Update the unified wizard

Edit packages/cli/lib/wizard.js to add your tool as a new step between service registration and MCP config.

3. Update the landing page

| File | What to change | |------|---------------| | web/src/pages/Landing/types.ts | Add install subsection if new section | | web/src/pages/Landing/components/ContentPanel/animatedContentScreens.ts | Add install screen (desktop + mobile) | | web/src/pages/Landing/components/TerminalPanel/terminalCommands.ts | Add install subcommand output |

4. Update agent-facing content

| File | What to change | |------|---------------| | web/public/llms.txt | Add tool with npx @robot-resources/<tool> | | web/public/llms-full.txt | Add detailed section with npx install | | web/public/.well-known/ai-resources.json | Add SoftwareApplication entry with InstallAction |

5. Update the publish workflow

Add your package.json path to .github/workflows/publish.yml triggers and add a publish step.

6. Add to root workspaces

Add your package directory to the workspaces array in the root package.json.

Architecture

packages/cli-core/    Shared auth, config, login (private — never published)
packages/cli/         This package (published as "robot-resources" on npm)
  bin/setup.js        Entry point
  lib/wizard.js       Orchestrator — add new tools here
  lib/service.js      launchd + systemd service registration
  lib/mcp-config.js   Agent detection + MCP JSON patching
  lib/python-bridge.js  Python venv management
  lib/detect.js       Environment detection
  lib/ui.js           Terminal formatting