Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ agent-device doctor
agent-device help workflow
```

Run `doctor` yourself before handing the CLI to an agent; `help workflow` links to the guides for debugging, replay, and profiling, and the installed help always matches the installed version.
Run `doctor` yourself before you hand the CLI to an agent. `help workflow` links to the guides for debugging, replay, and profiling.

### Drive an app from the CLI

Expand Down Expand Up @@ -61,7 +61,7 @@ agent-device screenshot ./contact-form.png
agent-device close
```

Refs are only valid from the latest output: after a `--settle` command, use the refs in its diff, and take a new snapshot only if the diff omits what you need. Snapshots come from the app's accessibility tree, so clear labels, roles, and test IDs make agent runs more reliable; use screenshots and video as evidence or when accessibility data is poor.
Refs are valid only in the latest output: after a `--settle` command, use the refs in its diff, and take a new snapshot only if the diff omits what you need. Snapshots come from the app's accessibility tree, so clear labels, roles, and test IDs make agent runs more reliable; use screenshots and video as evidence or when accessibility data is poor.

![agent-device demo showing Codex using agent-device to create a new contact in the iOS Contacts app from a simple prompt](./website/docs/public/agent-device-contacts.gif)

Expand Down Expand Up @@ -126,7 +126,7 @@ With the CLI installed, prompts like these work end to end:
## Next steps

- [AI Agent Setup](https://oss.callstack.com/agent-device/docs/agent-setup): skills, project rules, and per-client setup for Cursor, Codex, Claude Code, Windsurf, and others.
- [Quick Start](https://oss.callstack.com/agent-device/docs/quick-start): a guided run on the bundled Expo test app with screenshots, replay, and performance data.
- [Quick Start](https://oss.callstack.com/agent-device/docs/quick-start): open an app, read its UI, and interact with it from the command line.
- [Replay & E2E](https://oss.callstack.com/agent-device/docs/replay-e2e) and [Debugging & Profiling](https://oss.callstack.com/agent-device/docs/debugging-profiling): repeatable tests and bug hunting.

## Where to run agent-device
Expand All @@ -143,9 +143,9 @@ The same session and evidence model works at every step: the agent explores the

`agent-device` keeps device state in sessions. It uses a local accessibility bridge for iOS Simulator snapshots and XCTest for iOS interactions, physical iOS, and tvOS; ADB and the snapshot helper on Android; HDC and ArkUI `uitest` on HarmonyOS; Vega CLI/VDA on the Vega Virtual Device; a local helper on macOS; and AT-SPI on Linux.

Support depth varies by target. Newer backends such as HarmonyOS and Vega OS cover a subset of commands; run `agent-device capabilities --platform <platform>` to see what a target supports.
Support depth varies by target. Some backends, such as HarmonyOS and Vega OS, cover a subset of commands; run `agent-device capabilities --platform <platform>` to see what a target supports.

Sessions are scoped to the caller's git worktree, and host-local device claims stop parallel agents from taking over each other's simulators and emulators. Inspect ownership without a daemon via `agent-device device status`, and settle provably dead owners with `agent-device device release --stale`. The same commands drive hosted devices on [BrowserStack, AWS Device Farm, TestMu AI, and Limrun](https://oss.callstack.com/agent-device/docs/device-clouds).
Sessions are scoped to the caller's git worktree, and host-local device claims stop parallel agents from taking over each other's simulators and emulators. Run `agent-device device status` to inspect ownership without a daemon, and `agent-device device release --stale` to release claims whose owner is provably no longer running. The same commands drive hosted devices on [BrowserStack, AWS Device Farm, TestMu AI, and Limrun](https://oss.callstack.com/agent-device/docs/device-clouds).

`agent-device` uses the inspect-act-verify process from Vercel's [agent-browser](https://github.com/vercel-labs/agent-browser) for mobile, TV, and desktop apps. Basic `--platform web` support runs `agent-browser` in the same session and replay system.

Expand Down
2 changes: 1 addition & 1 deletion docs/adr/0013-unified-gesture-plans.md
Original file line number Diff line number Diff line change
Expand Up @@ -156,7 +156,7 @@ resolve after planning, and interpolation never splits a token, so the count is
values are not. The removal process these inputs follow — announce, warn for one minor release,
publish the migration guide, prove the repository is clean, then remove the branch and its tests —
is documented in the public
[gesture migration guide](https://agent-device.dev/docs/migrating-gestures).
[gesture migration guide](https://oss.callstack.com/agent-device/docs/migrating-gestures).

Repeated coordinate swipes are bounded at the public command contract and daemon trust boundary.
Individual count and pause limits prevent pathological fields, while the combined planned gesture
Expand Down
1 change: 1 addition & 0 deletions examples/sdk/tsconfig.json
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@
"agent-device/android-adb": ["../../src/sdk/android-adb.ts"],
"agent-device/contracts": ["../../src/sdk/contracts.ts"],
"agent-device/finders": ["../../src/sdk/finders.ts"],
"agent-device/selectors": ["../../src/sdk/selectors.ts"],
"agent-device/ai-sdk": ["../../src/ai-sdk/index.ts"]
}
},
Expand Down
4 changes: 2 additions & 2 deletions packages/provider-testmu/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ export LT_ACCESS_KEY=your-access-key
agent-device connect testmu --platform ios --device "iPhone 16" --provider-os-version 18.0 --provider-app ./MyApp.zip
```

See the [TestMu AI guide](https://agent-device.dev/docs/testmu) for setup and supported operations.
See the [TestMu AI guide](https://oss.callstack.com/agent-device/docs/testmu) for setup and supported operations.
To update the plugin, run `agent-device plugins update @agent-device/testmu`.

After adding or updating a plugin, close your sessions and run `agent-device daemon stop` before reconnecting.
After you add or update the plugin, close your sessions and run `agent-device daemon stop` before reconnecting.
2 changes: 1 addition & 1 deletion packages/provider-testmu/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -59,5 +59,5 @@
"url": "git+https://github.com/callstack/agent-device.git",
"directory": "packages/provider-testmu"
},
"homepage": "https://agent-device.dev/docs/testmu"
"homepage": "https://oss.callstack.com/agent-device/docs/testmu"
}
Loading
Loading