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
-
In Terminal on the Mac with Scrolly installed, run:
-
Paste the prompt it prints into your agent. It asks the agent to read the skill and run
scrollyctl setup statusfirst. - 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 readscrollyctl setup status --json before describing the next step and after you finish it. The setup report shows who can finish each step.
- A command such as
scrollyctl setup photos_add_accesscan 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 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.
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 for what to keep in your hands.