Skip to content

Try it without hardware

Farm Agent Simulator

A Farm Agent is a small program that runs beside your phones and talks to Cradle. This page is one — running in this browser tab. It registers with a real token, reports real devices, leases real jobs and reports every step over the same versioned contract a production agent uses. The only thing it fakes is the phone.

Three steps

  1. 1

    Press Connect

    If you are signed in, Cradle adds a Farm Agent to your workspace and connects this tab to it. Nothing to copy, nothing to install.

  2. 2

    Watch the phones appear

    Choose how many to simulate and how they should misbehave. They show up in your fleet within seconds, labelled Simulated.

  3. 3

    Use the product for real

    Add a social account, sign it in on a device, upload media, schedule a post. Everything runs end to end while this tab stays open.

Farm Agent Simulator

Runs in this tab and speaks the same contract a real agent does.

Not connected

Press Connect and Cradle does the rest

Signed in, it adds a Farm Agent to your workspace and connects this tab to it. If someone has given you a registration token instead, paste it below.

Only needed if someone gave you one. One-time, expires in two hours.

How long each step takes.

Make it go wrong

Real phones fail. Turn these on to watch Cradle recover — retries, accounts marked as needing sign-in, and jobs parked for a person.

One thing first

An agent connects to a workspace, so it needs a token from one.

Sign in and this page will create the agent for you — no copying tokens around. It takes one click once you are in.

Already been given a token by someone? You do not need an account — close this and paste it into Registration token.

What is real, and what is not

The simulator is not a demo mode inside Cradle. Cradle cannot tell it apart from a production agent, because there is nothing to tell apart — it is the same code path, over the same network, against the same database. That is the point: what you see here is what happens with real phones.

Genuinely real

  • Registration, and the one-time token being spent
  • Agent credentials, heartbeats and device sync
  • Job leasing, fencing-token leases and lease renewal
  • Media downloaded from private S3 through short-lived links
  • Account credentials released only for a live sign-in job, and audited
  • Every step reported over Farm Agent Contract v1
  • Retries, security challenges, sign-outs and cancellation

Simulated

  • The phone itself — there is no device driver behind the last hop
  • The social app: nothing is posted to TikTok, Instagram, X or LinkedIn
  • The published URL a job reports back

Every device it reports is labelled Simulated in your fleet, so a simulated phone can never be mistaken for a real one.

Things worth knowing

The tab is the machine
A real agent runs as a long-lived process. Here, this tab is that process — close it and the agent stops. Anything it was holding is released, and any job whose lease expires goes back into the queue and runs again. Nothing is lost; that recovery path is the same one that covers a Mac mini losing power.
Where the credential lives
Registering gives this tab an agent credential, which can lease work and receive account passwords for sign-in jobs — the same authority a real agent has. It is kept in this tab only, is cleared when you close it, and is never displayed. Use the simulator with a workspace you are happy to demo, and use Forget this agent on a shared computer.
Or run it on your own machine
The same simulator runs as a command-line program, which is closer to how a real agent is deployed and survives closing your browser. Cradle shows the exact command next to every registration token.