Files
sanderling/docs/manual/cli.md
T
pj e62319e916 docs: pandoc-based site and v0.1.0 groundwork (#5)
* chore(prose): remove em-dashes from config files

* chore(prose): remove em-dashes from android sdk config

* docs(spec-api): remove em-dash from README

* fix(doctor): reword sidecar-jar error without em-dash

* test(sidecar): reword assertion message without em-dash

* docs: add CLAUDE.md with project conventions

* build: add docs target for pandoc site

* docs(site): add pandoc template and stylesheet

* docs(site): add pandoc build script

* docs(site): add landing pages

* docs(manual): add getting-started

* docs(manual): add writing-specs

* docs(manual): add runs

* docs(manual): add cli reference

* docs(dev): add design principles

* docs(dev): add architecture

* ci: deploy docs site to github pages

* docs: rewrite README as entry point to docs site
2026-04-18 14:00:57 +07:00

1.3 KiB

title
title
CLI reference

CLI reference

uatu <command> [flags]

uatu test

Run a spec against an app for a fixed duration.

Flag Default Description
--spec required Path to the TypeScript spec.
--bundle-id required Target app bundle ID (Android: applicationId).
--launcher-activity resolved Optional <pkg>/<activity> to launch. Overrides default resolution.
--platform android Target platform. Only android in the current alpha.
--avd required (android) Android AVD name.
--duration 5m Total test duration (30s, 5m, 2h, 1d).
--seed 0 PRNG seed. 0 uses a random seed and records it in meta.json.
--output ./runs Output directory for traces.

uatu doctor

Check the host environment for a working uatu setup: Go toolchain, JDK, Maestro availability, emulator reachability, SDK linkage hints.

uatu version

Print the CLI version.

Flags coming in v0.1.0

  • --permissions to pre-set OS-level permissions (for example --permissions location=allow,notifications=deny).
  • --max-steps hard cap on step count.
  • --exit-on-violation stop the run on the first property violation.
  • uatu inspect command for browsing traces in the built-in UI.

Tracked in issue #4.