Overview

What AskUI is, how it works, platform support, and security.

First steps, free trial, and whether you need to write code.

CI/CD, model providers, virtual machines, proxy, and installation requirements.

Run status meanings, reports, and what a run costs.

Plans, on-premise options, billing errors, and reading credit consumption.

What you can automate, including embedded and proprietary UIs.

Experiencing a specific error or unexpected behavior? See Troubleshooting for step-by-step fixes, or Get help to contact the team.

Find your question

The docs answer these directly, each question links to the page that answers it.

Question	Answered in
What is a CUA agent, and how does AskUI execute a test?	How AskUI works
Why did the agent do it differently than last run?	Test automation harness
What leaves our network, and what is stored where?	Enterprise fit
Proxy, air-gapped use, CI runners, OS support?	Infrastructure requirements
Should testers, developers, or both own the testware?	Sharing the project
Can I run without an AskUI account?	License key activation

Question	Answered in
Which device kinds exist, and how do I create a profile?	Devices
How does a test know which device to use?	Devices → How a test picks its device
Does a desktop run take over my mouse and keyboard?	Devices → It uses your mouse and keyboard
What do the emulator's Booting / Ready states mean?	Android emulator → Run it
How do I test on a real Android phone?	Android phone
Can I test iOS from Windows?	iOS simulator
Can one agent drive several machines in one test?	Multi computer

Question	Answered in
How do I create a test case, and what shape does it have?	Test cases
Which file formats can a test case have?	Test case formats
When do I use setup.md, teardown.md, rules.md?	Setup, Teardown & Rules
How do I reuse a step sequence across tests?	Procedures
How do I keep credentials out of test files?	Secrets
Can one case target desktop and mobile together?	Test cases → Target multiple platforms
How do I skip a case temporarily?	Test cases → skip
How do I group tests into smoke / regression sets?	Plans
What can a step express, conditions, waits, checks?	Step constructs
How do I write steps the agent executes reliably?	Writing good tests

Question	Answered in
How do I start a run, and what happens during one?	Running a test
Can I watch the agent while it works?	Running → Watch it live
How do I run suites automatically every day?	Scheduling
How do I run headless in CI?	AskUI in CI
How do I read the report, and what do the statuses mean?	Run report
Where do I see trends across runs?	Dashboard
A test failed, how do I find out why, and where do I fix it?	Analyzing failures

Question	Answered in
What is the agent allowed to do, and how do I restrict it?	Tools
The built-in tools aren't enough, now what?	Custom tools · MCP servers
Can I use my own AI model instead of the AskUI hub?	Model providers