Autonom documentation

Let your agent drive an iOS Simulator or an Android emulator, and bring back proof of what it saw.

Quick start

Four steps in a terminal, then your agent takes over.

  1. Get the code.

    Clone the repository and step into it.

    git clone https://github.com/aiatsuk/autonomcd autonom
  2. Install it.

    A checklist asks which device tools to add. Tick your agents too, and each one gets the skills.

    ./install.sh
  3. Ask what this machine can do.

    Green means installed, not proven. Anything missing comes with the exact fix.

    autonom doctor
  4. Take the tour.

    Start a new agent session so it loads the skills. Then take the guided walk on your device.

    autonom tour

Your first check

Topics

Six groups, in the order you are likely to need them.

  1. Start

    Install Autonom, run a first check and learn how your agent owns a device.

  2. Drive

    Read the screen and act on it by what each element says.

  3. Observe

    Keep what proves a change, see what the app sent, and hand a run to your agent.

  4. Automate

    Save a check once, run it in CI on every change, and pre-test a ticket before QA.

  5. Go further

    Measure the app, and watch the device in your browser.

  6. Reference

    Look up an error code, what consent covers, and what a target can do.

How Autonom works

  • Skills and one command line. Your agent loads skills that say what to do, and runs autonom, a command line that answers in JSON. No MCP server is needed.

  • One explicit target. A session owns one device. With more than one ready, your agent names the one it means, or gets an error listing the candidates.

  • The evidence ladder. Each rung is stronger evidence, from code and tests to the screen, logs, performance and a before and after replay. Your agent climbs as far as the claim needs.

Your agentreads the taskSkillssay what to doautonomanswers in JSONOne targetAndroid or iOSEvidenceshots and logs Your agentreads the taskSkillssay what to doautonomanswers in JSONOne targetAndroid or iOSEvidenceshots and logs
Your agent follows the skills and runs one command line against one target.

Search documentation

Type to find a guide.

↑ ↓ to move · Enter to open · Esc to close