# Setup

> Check and install prerequisites for upstack. Verifies git, gh, agent-browser, and skill symlinks. Use when first setting up or troubleshooting.

- Skill: `upsolve-labs/setup` (Agent Skill)
- Install (CLI): `npx skillmds@latest add upsolve-labs/setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/upsolve-labs/setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Upsolve-Labs (https://skillmd.com/u/upsolve-labs)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/upsolve-labs/setup

---


## Update Check (run first)

```bash
_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.