Optics documentation

Create a test once, the way that suits you, then run it on every build and every device. Start with a five-minute quickstart, or jump to the part you need.

Start the quickstart What is Optics?

Your first run

$ curl -fsSL https://optics-framework.org/install | sh
$ optics quickstart
What do you want to automate? [mobile/web] (mobile): web
Project ready at: /Users/you/my-optics-project
$ optics execute my-optics-project
Total Test Cases: 3 | Passed: 3 | Failed: 0

Choose your path

Each path builds on the one before it. You don't need the advanced features to get value from Optics.

New to Optics

Run your first test

Install Optics, run a working sample, then write a test of your own against a real website.

Building a suite

Cover your app

Pick how your team creates tests, make elements survive redesigns, and run the suite on every build.

Going further

Automate more

Drive tests from data, call APIs mid-test, and connect Optics to your AI agent or your own services.

Create a test your way

Every way ends in the same plain-text files, so you can mix them in one project.

Write it in a spreadsheetNo code needed. List the steps in CSV or YAML. Anyone on the team can read and review them. Record it on the deviceNo code needed. Run one step at a time in optics live. Every step that works is saved. Describe it in plain EnglishUses an AI model. Tell Optics what to do. An AI model drives the device and keeps the steps that mattered. Hand it to your AI agentUses an AI model. Connect optics mcp to your agent. It explores the app and writes the suite.

Browse the docs

Get started

Create tests

Find elements

Run and report

Platforms

Advanced

Reference

Help

For AI agents

Every page is also available as Markdown. Add .md to a docs URL, or start from the docs index for agents.