<!-- Generated by tools/build_reference.py from assets/operations.json. Do not edit. -->

# Tomacco references

250 operations in all, in 31 files, one per area. Read the file of the area you need, not all of them. Each operation lists its arguments (required first) and one example call; `tomaccoctl help OPERATION` prints the same with the full argument descriptions. [Error codes](errors.md).

| File | Operations | Areas and names |
| --- | --- | --- |
| [general](general.md) | 2 | Machine readiness, setup and diagnostics. `doctor`, `capabilities` |
| [agent](agent.md) | 1 | The policy this agent session runs under. `agent.policy` |
| [android](android.md) | 32 | Emulators and devices: input, files, settings, SDK, AVDs, store screenshots. `android.screen`, `android.store_screenshots`, `android.input`, … |
| [apple](apple.md) | 10 | Xcode tools on macOS hosts: build, test, archive, export, simulator. `apple.devices`, `apple.project`, `apple.build`, … |
| [audit](audit.md) | 1 | Log of operations that changed something. `audit.list` |
| [catalog](catalog.md) | 4 | Saved project and device catalogue. `catalog.list`, `catalog.import`, `catalog.export`, … |
| [debug](debug.md) | 10 | Debugger sessions: breakpoints, threads, stack, variables. `debug.start`, `debug.list`, `debug.state`, … |
| [desktop](desktop.md) | 2 | The desktop app's state and window. `desktop.status`, `desktop.open` |
| [device](device.md) | 8 | Devices of either platform: list, install, capture, logs. `device.list`, `device.info`, `device.label`, … |
| [diagnostics](diagnostics.md) | 1 | Bug-report bundle with secrets masked. `diagnostics.bundle` |
| [files](files.md) | 5 | Files inside the allowed roots. `files.list`, `files.read`, `files.write`, … |
| [ios](ios.md) | 16 | iPhone over USB, iOS toolkit, signing, store upload. `ios.sdk_install`, `ios.toolkit_install`, `ios.flutter_setup`, … |
| [ios-research](ios-research.md) | 22 | Research engine steps behind the virtual iPhone. `ios.emulator.inspect`, `ios.emulator.probe`, `ios.emulator.exec`, … |
| [ios-virtual](ios-virtual.md) | 21 | The virtual iPhone: setup, start and stop, deploy, states, screenshots. `ios.virtual.status`, `ios.virtual.host_check`, `ios.virtual.doctor`, … |
| [job](job.md) | 7 | Jobs started by long operations: wait, logs, cancel. `job.list`, `job.get`, `job.logs`, … |
| [play](play.md) | 3 | Google Play upload. `play.prepare`, `play.commit`, `play.abort` |
| [preview](preview.md) | 16 | Live previews of web and app screens. `preview.sessions`, `preview.state`, `preview.navigate`, … |
| [profile](profile.md) | 14 | Startup, frames, memory, macrobenchmark and baseline profiles. `profile.capture`, `profile.analyze`, `profile.compare`, … |
| [project](project.md) | 11 | Open, plan, create, build, run and watch projects. `project.inspect`, `project.configure`, `project.create`, … |
| [release](release.md) | 7 | Signing, version, notes and release checklist. `release.keystore`, `release.sign`, `release.verify`, … |
| [remote](remote.md) | 6 | Remote build hosts. `remote.list`, `remote.configure`, `remote.check`, … |
| [result](result.md) | 1 | Read a large result a call stored. `result.read` |
| [runtime](runtime.md) | 8 | Runtime sessions for emulated devices. `runtime.start`, `runtime.list`, `runtime.audio`, … |
| [screen](screen.md) | 8 | Understand a screen: marks, text recognition, tree, diff, waiting. `screen.marks`, `screen.tap`, `screen.tree`, … |
| [settings](settings.md) | 2 | Tomacco settings and agent policy. `settings.get`, `settings.configure` |
| [storage](storage.md) | 1 | Free disk space by pruning Tomacco's caches. `storage.prune` |
| [swift](swift.md) | 5 | Swift on Android. `swift.status`, `swift.android_configure`, `swift.sdk_install`, … |
| [testing](testing.md) | 16 | UI selectors, actions, test runs, results, accessibility. `testing.find`, `testing.action`, `testing.run`, … |
| [update](update.md) | 4 | Tomacco's own updates. `update.check`, `update.apply`, `update.status`, … |
| [workflow](workflow.md) | 1 | Run up to 20 operations in order in one call. `workflow.run` |
| [workspace](workspace.md) | 5 | Workspaces of projects and shared context. `workspace.list`, `workspace.save`, `workspace.remove`, … |