Introduction

Autonoma is an agentic end-to-end testing platform. Users create and run automated tests for web, iOS, and Android applications using natural language. The system executes tests on real devices and emulators, with AI models handling element selection, assertions, self-healing, and agentic decision-making.

Using these docs with AI

These docs are available as plain text for LLMs. Pass the link below to your coding agent (Claude Code, Cursor, Copilot, etc.) so it can read the full documentation in context:

https://docs.agent.autonoma.app/llms.txt

The file links to every page individually, so the model can fetch only what it needs. A single complete file with all pages is also available.

Getting started

There are two paths depending on where you are:

How Autonoma runs tests

Before each test run:

1. Autonoma calls your endpoint with action: "up" and a scenario name
2. Your endpoint creates isolated test data and returns auth credentials
3. Autonoma uses those credentials to log in and run the test
4. After the test, Autonoma calls action: "down" with signed refs
5. Your endpoint verifies the signature and deletes only the data it created

The signed refs mechanism ensures teardown can never delete data it didn’t create - even if someone gains access to your endpoint.

Framework examples

Contributing

Want to run Autonoma locally or contribute to the project? Start here: