docs(cli-reference): npx one-liner install — mirror insta-cli#110 setup agent self-install

Merged
TO
3mo ago
+21-7

Mirrors InsForge/insta-cli#110 per the CLI repo's rule 4 (command changes → cli-reference.md).

  • insta setup agent row: documents the CLI self-install (npm channel + no durable insta on PATH → npm i -g insta@<running version>, best-effort, CLI ≥ 0.0.37) that makes npx -y insta setup agent a complete cross-platform one-liner.
  • Install one-liners section: adds the npx form (any OS/shell, Node 18+) above the curl forms, scopes curl | sh to macOS/Linux with a never-on-native-Windows warning (PowerShell curl alias + WSL bash shim), and documents the staging-via-npx ordering (insta env use staging before setup agent).

Context: Windows users piping the curl installer in PowerShell hit Invoke-WebRequest prompts and WSL execvpe(/bin/bash) failures — see InsForge/insta-landing#29 for the landing-doc side of this fix.

Merge after insta-cli#110 ships in a release (the CLI ≥ 0.0.37 gate keeps it accurate either way).

🤖 Generated with Claude Code

Summary by cubic

Promotes npx -y insta setup agent as the cross‑platform install by documenting the CLI’s best‑effort global self‑install, and fixes staging vs. npm channel guidance to prevent broken Windows installs and mismatched builds.

  • CLI reference: insta setup agent now notes global self‑install when launched from the npx cache with no durable insta on PATH (npm i -g insta@<running version>; continues on failure; CLI ≥ 0.0.37), enabling the one‑liner on any OS/shell (Node 18+).

  • Install docs: lead with npx -y insta setup agent; scope curl | sh to macOS/Linux and add a “never on native Windows” warning; document staging via npx ordering (npm i -g insta, insta env use staging, then insta setup agent); remove the “CLI build matches env” claim and state npm/npx always install the stable CLI, while prerelease/staging uses the curl installer (insta@next only for deliberate prerelease tests).

  • Setup reference: mirrors the npx‑first guidance and Windows warning; notes staging host isn’t live yet and includes the raw URL fallback.

  • Rollout: merge after CLI ≥ 0.0.37 ships. No migration required.