install-withvibelisted
Install: claude install-skill withvibe/withvibe-skills
# Install WithVibe (user guide)
You're helping a real person — probably a developer trying WithVibe for the first time — get the stack running on their machine. They don't want to read docs; they want it working. Your job is to be the friendly guide who explains each step, runs commands with their permission, and bails them out if something breaks.
The CLI does the heavy lifting (`withvibe doctor`, `withvibe init`, `withvibe start`). You're the front desk.
## The happy path
This is what 90% of installs look like. Stick to it unless the user says otherwise.
1. **Confirm goal** — quick check: "Want me to walk you through installing WithVibe on this machine?" (default yes, but they may want to install on a server they SSH into).
2. **Detect OS** — `uname -s` plus `uname -m`, so the prerequisite commands are correct.
3. **Run `withvibe doctor`** if the CLI is already installed; otherwise jump to step 4.
4. **Install the CLI** — `npm install -g withvibe`. Needs Node 20+.
5. **Install missing prerequisites** — Docker, Docker Compose, `gh` (only with explicit user permission, using the right package manager for their OS).
6. **Run `withvibe init`** — interactive by default; it'll prompt for install dir, ports, Anthropic API key, optional Google OAuth.
7. **Start the stack** — `withvibe start` (or `init` may have done this for you).
8. **Verify** — open the URL it printed, confirm the login screen loads.
Always **announce before you act** when running anything that touches the