LibreAI / AI Agents / agent-device
// agents · callstack/agent-device

agent-device

Mobile app automation and verification built for AI coding agents — CLI, MCP server, and Node API

★ 4.9k stars⑂ 328 forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

agent-device is an open-source ai agents project by callstack (callstack/agent-device on GitHub). It has 4,936 GitHub stars and 328 forks, is released under the MIT license, and was last updated on GitHub on 8 October 2026.

GitHub stars
4,936
Forks
328
License
MIT
Last updated on GitHub
8 October 2026
Category
AI Agents
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Check your goal

    Decide which apps and platforms your agent must verify — iOS simulator, Android emulator, a physical device, web, or desktop.

  2. Install the CLI

    Install agent-device globally from npm; it requires Node.js 22.12 or newer (Node 24+ for web automation).

  3. Verify your setup

    Run the doctor command yourself before handing the CLI to an agent, and review the workflow guides.

  4. Run your first session

    Open an app, take an accessibility snapshot, act on a ref, and capture a screenshot as evidence.

// features

Why people love it

Accessibility snapshots

Agents inspect app state through token-efficient accessibility trees, refs, and selectors rather than screenshots alone.

Act on the UI

Tap or press elements, fill fields, scroll, use gestures, wait, assert state, and handle alerts.

Debugging evidence

Capture screenshots, video, logs, traces, network data, performance samples, and crash details.

Replay scripts

Save working steps as .ad scripts for local use or CI, with export to strict Maestro YAML when needed.

MCP server built in

`agent-device mcp` starts a stdio MCP server exposing the same commands as structured tools.

Parallel-safe sessions

Sessions are scoped to the caller's git worktree, and host-local device claims stop parallel agents from taking over each other's simulators; remote device clouds such as BrowserStack and AWS Device Farm are supported.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone the project and enter its directory (or skip the clone and install from npm in the next step).

    git clone https://github.com/callstack/agent-device.git
    cd agent-device
  2. Install the CLI

    Install agent-device globally; Node.js 22.12+ is required.

    npm install -g agent-device@latest
  3. Check setup and drive an app

    Run the doctor check, then open an app and inspect it.

    agent-device doctor
    agent-device open Contacts --platform ios
    agent-device snapshot -i
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains agent-device?

Callstack, the React Native consultancy; the README notes teams at companies such as Expensify and Shopify use it.

Is agent-device free?

Yes, the tool itself is open source under the MIT license. Optional remote device clouds it can connect to (such as BrowserStack or AWS Device Farm) are separate paid services.

Does it need a paid API key?

No API key is required for the CLI, MCP server, or Node API themselves; you bring your own coding agent (for example Claude Code or Codex) to drive it.

How does it compare to Appium, Detox, or Maestro?

Those tools run test suites that humans write and maintain; with agent-device, an agent reads app state and chooses each command at run time. It complements them — runs can be saved as .ad scripts or exported as strict Maestro YAML.

How do I get started?

Run `npm install -g agent-device@latest`, then `agent-device doctor`, open an app with `agent-device open`, and inspect it with `agent-device snapshot -i`.

// keep exploring

Similar tools

AI Agents

agent-browser

A fast browser-automation CLI built for AI agents.

★ 43.6k starsApache-2.0
View guide →
AI Agents

oh-my-agent

Open ai agents for mechanical verification for ai coding agents — skills p.

★ 1.3k starsMIT
View guide →
AI Agents

matlab-mcp-server

Official MathWorks MCP server: drive MATLAB from AI coding agents.

★ 1.6k starsNOASSERTION
View guide →
AI Agents

deep-research

Deep Research with any LLM: in-depth reports in minutes, with an SSE API and MCP server built in

★ 4.7k starsMIT
View guide →
AI Agents

chrome-devtools-mcp

Chrome DevTools for coding agents: an MCP server that lets agents debug and inspect real Chrome

★ 53.1k starsApache-2.0
View guide →
AI Agents

brightdata-mcp

Bright Data's MCP server: web search, scraping, structured data and browser automation for agents (75 tools)

★ 2.7k starsMIT
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if agent-device is not the right fit.

Get agent-device

Free and open — grab the source, star the repo, and start creating.