install

name	install
namespace	user
description	Fresh-machine bootstrap of the ralphy CLI binary. Read docs/playbooks/ralphy-install.md FIRST via the Read tool — every time, no exceptions. USE WHEN the ralphy binary is NOT yet on PATH and the user needs to get it onto their machine — install the standalone binary from GitHub Releases, ensure bun + ffmpeg are present, run the interactive setup wizard, link to the user's checkout of ugc-cli. Once `ralphy --version` works and the project is linked, hand off to ralph-core for in-tree dev tasks. TRIGGER (EN): "install ralphy", "set up from scratch", "fresh machine", "first run", "bootstrap the CLI", "I just cloned the repo", "I don't have ralphy yet", "ralphy not found", "/install". ALSO FIRE if `which ralphy` returns nothing in a session about to use ralphy commands, OR `ralphy status` errors with "Could not locate the ugc-cli project". DO NOT FIRE if ralphy is already installed and the user just wants `ralphy doctor` / env check (that is ralph-core), or wants to install template assets from the companion repo (that is `ralphy assets`). KEYWORDS: install, bootstrap, fresh machine, ralphy binary, GitHub Releases, install.sh, bun, ffmpeg, ralphy setup, setup wizard, PATH, ~/.local/bin/ralphy, link project.

install (shim)

The full role instructions have moved to docs/playbooks/ralphy-install.md.

Read that file completely via the Read tool before bootstrapping a fresh machine. It walks through the four sub-tasks (check-environment, install-ralphy, run-setup-wizard, verify) and the fallbacks. Do not improvise from this shim.