> ## Documentation Index > Fetch the complete documentation index at: https://docs.autogrowth.farm/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > AutoGrowth runs social accounts on real phones. Everything a page describes happens on a physical device in the customer's own fleet, never through a social platform's API. > The Companion is a macOS desktop app that runs on the customer's own Mac and manages the phones over USB — iPhones through WebDriverAgent, GrapheneOS phones through ADB and scrcpy. Nothing runs while the Companion is closed. > The Companion builds, signs and installs WebDriverAgent on each iPhone itself. Never tell a customer to sign WebDriverAgent by hand in Xcode; Xcode is a prerequisite the Companion drives, not a step the customer performs. > Autogrowth MAX is a one-time, invite-only lifetime license bought from the organization's credit balance, not a subscription tier. It is required to run any automation, workflow or Incubator program. Without a price set for that organization, the purchase is refused. > An automation is one of AutoGrowth's built-in definitions; a script is a graph the customer builds in the Script Builder. The Script Builder is locked platform-wide, so never present building a script as something a customer can do today. > An API key is a bare 64-character hex string with no prefix. It is shown once, at creation, is sent as `Authorization: Bearer `, and can never be read back. > An API key sees only the key owner's own accounts, content, collections, prompts, scripts and executions. Devices and tags are organization-scoped, and a non-owner sees only the devices assigned to them or carrying one of their tags. The automation catalog is global. > There is no pagination. List endpoints return the whole set; the only limiting parameter anywhere is `limit` on `GET /v1/executions`, which defaults to 50 and has no offset to page with. > Remote control and the live screen are dashboard-only, over WebSocket and MJPEG. Neither is part of the public API. > The MCP server is hosted at https://mcp.autogrowth.farm and authenticates with OAuth. It is not an npm package and there is nothing to install locally. Its tools inherit exactly the scope of the API key behind them. > Android support is partial and GrapheneOS-only: those phones appear in the fleet and can be watched and remote-controlled, but they cannot run scripts or automations. > Never document Hi Katie or any persona feature. When a page and the code disagree, the code wins — check a claim against the source before repeating it. # Automations > The built-in routines your phones run, what each one needs from you, and the licence they all sit behind. An **automation** is one of AutoGrowth's own built-in routines. It runs on a phone in your fleet: the phone opens the real app and drives it like a person would — taps, scrolls, typing. Nothing goes through a social platform's API, and nothing runs while the Companion on your Mac is closed. There are twenty of them, and the list is fixed. You choose one, fill in its inputs, pick a phone or an account, and say when. One of those runs is called an **execution**, and you watch it on the [Schedule](/guides/scheduling) screen. A [workflow](/guides/workflows) is a set of automations that repeats every day. ## Everything here needs Autogrowth MAX Running an automation — one now, one scheduled, a hundred in bulk, or a daily workflow — requires the Autogrowth MAX licence. Without it, the server answers: > Autogrowth MAX is required to run automations. MAX is a one-time, invite-only lifetime licence, paid for from your organization's credit balance. There is no monthly automation plan and no trial. If MAX has not been offered to your organization, buying it is refused with "Autogrowth MAX is invite-only. Contact us for access." See [Credits and billing](/guides/billing). One automation costs more on top. **Create Account** needs the create-account add-on, a separate one-time purchase for the whole organization: > The Create Account add-on is required to run this automation. There is no way around that one — not even for staff. It is unlocked by payment only. Automations reach iPhones only. GrapheneOS phones can be watched and driven by hand, but they cannot run automations or scheduled work at all. See [Android phones](/guides/android-phones). ## The catalogue Names repeat across platforms — there are four different **Log in** automations and three different **Post** automations — so always read the platform column with the name. The last column says whether an automation can be a step in a [workflow](/guides/workflows). The ones that cannot are one-off setup jobs: a daily routine fans out across every account on the phone, and logging in twelve accounts every morning makes no sense. ### Instagram | Automation | What it does | Main inputs | In a workflow | | ---------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------- | | **Warmup** | Opens Instagram and scrolls the feed to warm up the account. | Account, **Duration (minutes)** — 30 by default. | Yes | | **Post** | Posts images or videos as a Post, Reel or Story. | Account, **Media** from your library, **Post Type**, **Caption**. Optional: audio search, people to tag, location, an AI-generated label, trial posting for Reels, a Story link, and **Audience** (everyone or close friends). | Yes | | **Edit Profile** | Changes name, username, bio, link or picture. | Any of **Display Name**, **Username**, **Bio**, **Bio Link URL**, **Bio Link Title**, **Profile Picture**, **Switch to Professional**. Blank fields are left alone. | Yes | | **Like Stories** | Likes stories from the story feed. | Account, **Stories to Like** — 1 by default. | Yes | | **Interact with Post** | Opens one post and likes, comments and/or reposts it. | **Post URL**, then **Like** (on by default), **Comment** plus **Comment Text**, **Repost**. | Yes | | **Create Account** | Creates a new Instagram account with a rented phone number and SMS verification. | **Username**, **Password**, **Age**, **Container**, **Verification Method** (phone or email), **Phone Country**, **SMS Provider**. Needs the add-on. | Yes | | **Log in** | Logs an existing account into a container, handling 2FA. | **Container**, **Username**, **Password**, **2FA Secret**. | No | | **Confirm login** | Checks whether a username is actually logged in, through the account switcher. | Account. | No | **Confirm login** is queued for you automatically after a successful Instagram **Log in** — you do not normally schedule it yourself. ### TikTok | Automation | What it does | Main inputs | In a workflow | | ---------------- | ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- | ------------- | | **Warmup** | Opens TikTok and scrolls the For You page. | Account, duration in minutes. | Yes | | **Post** | Posts **images only**, as a photo post. | Account, media, **Title** (required), description, audio search, **Who Can View**. | Yes | | **Edit Profile** | Edits photo, name, username and bio. | **Profile Photo**, **Name** (30 characters), **Username** (24), **Bio** (160), and whether to post the photo to your story. | Yes | ### X | Automation | What it does | Main inputs | In a workflow | | ------------------ | --------------------------------------------------------------- | ------------------------------------------------------------ | ------------- | | **Post** | Posts a tweet with text, media or both. | Account, **Tweet Text** (leave blank for media-only), media. | Yes | | **Switch Account** | Opens X and switches to the selected account. | Account. | Yes | | **Log in** | Logs an existing account into a container, handling 2FA. | Container, username, password, 2FA secret. | No | | **Add account** | Adds a second account to a container that is already logged in. | Container, username, password, 2FA secret. | No | ### Threads | Automation | What it does | Main inputs | In a workflow | | ---------------------- | -------------------------------------------------------------------------------- | ----------------------------------------- | ------------- | | **Post** | Posts to Threads. | Account, caption, media, music, location. | Yes | | **Interact with Post** | Opens one post and likes, comments and/or reposts it. | Post URL, like, comment, repost. | Yes | | **Switch Account** | Opens Threads and switches account. | Account. | Yes | | **Open Threads** | Opens the app and closes it again. | None. | Yes | | **Log in** | Signs Threads in using the Instagram account already logged into that container. | None — no credentials needed. | No | Media inputs are pulled from your [content library](/guides/content-library), never uploaded into the automation itself. Container inputs point at a [container](/guides/containers) that already exists on the phone, except in **Create Account**, which can also provision a fresh one. ## Two switches on every run Both sit on the run itself, not on the automation, so you set them each time you schedule something. | Switch | Default | What it does | | ---------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **AI recovery** | Off | "Use AI to recover from unexpected popups (uses your Claude API key)". When something unexpected covers the screen mid-run — a dialog, a verification prompt — the phone sends the screen off to be read and tries to clear it instead of failing. | | **Switch mobile data** | On | "Cellular data is cycled off and back on right before the run so the carrier assigns a fresh IP." Turn it off and "the run starts on whatever IP the phone already has." | AI recovery uses **your own** Claude API key, set in **Settings** under **Claude API Key**. Without one the run reports "Claude API key not configured. Please set it in Settings." ## When a log-in fails The five session automations — the Instagram, X and Threads **Log in** jobs, **Add account** and **Confirm login** — are the ones that decide whether an account is usable. If one of them fails outright, the account is marked **Error** on the [Accounts](/guides/accounts) page instead of the healthy **Warming**. A later success clears it. ## Scripts You will see **Scripts** in the navigation, a **Scripts** tab beside **Automations** whenever you schedule something, and a *Create/edit/run scripts* permission in [roles](/guides/team). A script is a routine you would build yourself in the Script Builder, block by block, instead of choosing one from the catalogue above. It is not available. The Script Builder is locked for every organization — the nav badge reads **Soon**, the create button is disabled, and the server answers "The Script Builder is coming soon and is not available yet." It cannot be bought either. Everything a phone does today is one of the twenty automations. ## What to read next Run one now, schedule one for later, or fill a whole week in one go. Turn a set of automations into a daily routine for a phone. Where the media in a posting automation comes from. MAX, the create-account add-on, and how credits work.