> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryscrolly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup skill

> Install scrolly-setup so your AI agent can read the Mac's checklist and guide you through setup.

`scrolly-setup` tells your AI agent how to read the setup checklist on this Mac, explain the next step and run the commands it is allowed to run. You do the parts that need your browser, an account sign-in or the phone.

## Install it

1. In Terminal on the Mac with Scrolly installed, run:

   ```bash theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
   scrollyctl skill install
   ```

2. Paste the prompt it prints into your agent. It asks the agent to read the skill and run `scrollyctl setup status` first.

3. For a Mac that still needs linking, approve it yourself in the browser or give the agent a one-time pairing code from **Add a Mac**.

## Where it installs

By default the command writes `~/.claude/skills/scrolly-setup/SKILL.md` for Claude Code. Pass `--dir <folder>` to use a different agent's skills folder if it supports that format. Run the install command again after updating Scrolly to refresh the skill.

## What the agent does

The agent should read `scrollyctl setup status --json` before describing the next step and after you finish it. The [setup report](https://docs.tryscrolly.com/reference/scrollyctl.md#the-setup-report) shows who can finish each step.

* A command such as `scrollyctl setup photos_add_access` can open a permission prompt for you to answer on the iPhone. Run any command that needs your Mac password in your own Terminal.
* A browser step needs you or an Admin to complete it. During WDA setup, select the driver mode in the console. The [developer setup guide](https://docs.tryscrolly.com/guides/older-ios-advanced-setup.md) shows the current install order.
* A WDA build can take a few minutes. Keep the iPhone plugged in and unlocked while the Mac installs and starts the driver app.

The skill also allows `scrollyctl status` to check the local services, `scrollyctl restart` if Scrolly isn't running or the connection keeps failing, and `pmset -g` to read the sleep setting. It may save a team ID with `scrollyctl wda team` if the Mac app can't find the team, or run `scrollyctl wda setup` after you've fixed a build failure and asked to see the build. See [Using AI agents](https://docs.tryscrolly.com/agents/using-agents.md) for what to keep in your hands.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.