setup

name	setup
description	Check and install prerequisites for upstack. Verifies git, gh, agent-browser, and skill symlinks. Use when first setting up or troubleshooting.
disable-model-invocation	true

Update Check (run first)

_UPD=$(~/.claude/skills/upstack/bin/upstack-update-check 2>/dev/null || .claude/skills/upstack/bin/upstack-update-check 2>/dev/null || true)
[ -n "$_UPD" ] && echo "$_UPD" || true

If output shows UPGRADE_AVAILABLE <old> <new>: read ~/.claude/skills/upstack/skills/upgrade/SKILL.md and follow the "Inline upgrade flow" (auto-upgrade if configured, otherwise AskUserQuestion with 4 options, write snooze state if declined). If JUST_UPGRADED <from> <to>: tell user "Running upstack v{to} (just updated!)" and continue.

Setup

Check Prerequisites

Run checks silently, then report a summary table:

Tool	Check	Required By
git	git --version	all skills
gh	gh --version	/ship-pr, /review, /advisor
gh auth	gh auth status	/ship-pr, /review, /advisor
agent-browser	agent-browser --version	/plan, /execute, /validate, /qa-review
node	node --version	/validate (JS projects)
python	python3 --version	/validate (Python projects)

Report

Print table with status for each tool. Mark required tools vs optional.

Fix Missing Tools

If required tools are missing, AskUserQuestion: "Missing: [list]. Should I show install commands?"

Install commands (never run automatically). Detect OS for appropriate package manager:

gh (https://cli.github.com/):

• macOS: brew install gh then gh auth login
• Linux (apt): see https://github.com/cli/cli/blob/trunk/docs/install_linux.md
• Linux (dnf): sudo dnf install gh then gh auth login
• Windows: winget install --id GitHub.cli then gh auth login

agent-browser by Vercel (https://github.com/vercel-labs/agent-browser):

• macOS: brew install agent-browser then agent-browser install
• Other: npm install -g agent-browser then agent-browser install (requires Node.js)

Verify Skill Symlinks

List all skills in ~/.claude/skills/ that point to the upstack repo. Report any broken or missing symlinks. If symlinks are broken: suggest re-running install.sh.

Optional: Linear

If user mentions Linear: check for Linear MCP server configuration. Explain which skills benefit (plan, advisor, ship) and how to set it up.