foundry/Docs
Start free trial
DocsGet started

Set up with your agent

Paste one brief into Claude Code, Codex or Cursor and it sets Foundry up, stopping for the taps only you can do.

The brief

After checkout, your welcome page and your dashboard (under Setup) have a brief with your license key already in it. Paste it into your agent on the Mac your iPhones plug into.

The agent installs Foundry, activates your key, connects each phone and runs the schedule. The only taps left to you are on the phone itself, listed below, and the agent tells you exactly which one is next.

Install

One line in Terminal on that Mac, with your own key in place of <key>. It downloads the current release for your license, unpacks it in your home folder, installs the foundry command and activates the key on this Mac. It never touches a phone.

Terminal
curl -fsSL https://runfoundry.app/install.sh | sh -s -- <key>

Or by hand

Press Download Foundry under Setup on your dashboard, then:

Terminal
tar -xzf ~/Downloads/foundry-*.tar.gz -C ~
~/foundry-*/foundry/install.sh
foundry license activate <key>
foundry doctor

The first phone

foundry doctor lists what is still missing on this Mac and what to run next. The full guide ships inside the download as README.md.

The first line makes a new Terminal window find the command. If this Mac has met more than one phone, foundry enroll lists them and you pick yours with foundry enroll --udid and its id.

Terminal
export PATH="$HOME/.local/bin:$PATH"
foundry enroll
foundry lane up <phone> --team <your Apple Developer team id>
foundry lane enable <phone>
foundry accounts add --id instagram-myhandle --platform instagram --phone <phone> --handle myhandle
foundry warm-plan
foundry install-agents

Who does what

You (a few taps, once)Your agent
Plug in the iPhone, unlock it, tap TrustDetects the phone and waits until it is ready
Turn on Developer Mode and restartChecks the phone's settings and tells you what to change
Sign in to Xcode with your Apple IDBuilds and installs the Foundry runner on the phone
Trust the developer certificate on the phoneConfirms the runner is installed and healthy
Log in to Instagram, TikTok and YouTubeLinks each account to its phone and checks the handle
Approve the first postPosts it and hands you the receipt