- React Native and mobile developers using AI coding assistants
- Teams that want agents to reproduce bugs, run UI tests, and profile performance on simulators autonomously
- Developers using Claude Code, Cursor, Codex, or Gemini who build for iOS and Android
openagent @ argent ~ $
cat README.md
Argent
Agentic toolkit that gives AI assistants direct access to iOS Simulators and Android Emulators.
$
npx @swmansion/argent initInstalling Argent...
Argent ready
$
npm install -g @swmansion/argent && argent initReading argent configuration & environment...
●
Waiting for input... # core strengths
What makes Argent different
◆
Direct simulator control without XCUITest overhead
Argent talks to the simulator directly instead of routing through XCUITest, making interactions faster and more context-efficient for agents.
XCUITest requires switching between test runner and app for every action, which is slow and wasteful for agent loops. Direct control means the agent can tap, swipe, and type without waiting.◆
Deep diagnostic suite beyond UI interaction
Argent can attach the debugger, explore view hierarchy, read console logs, evaluate expressions, inspect React component tree, read network requests, and run Xcode Instruments profiling.
Most simulator tools only handle UI interaction. Argent lets agents go from reproduction → diagnosis → fix in one session without leaving the CLI.◆
React Native and Expo native support
Argent works with React Native apps out of the box — agents can build, launch, and iterate on RN projects the same way they would native apps.
React Native developers are often caught between native tooling and JS workflows. Argent bridges that gap with zero extra setup.◆
MCP-native architecture
Argent runs as an MCP server over stdio, natively supported by Claude Code, Cursor, Copilot, Codex, Gemini, OpenCode, Windsurf, and Zed.
MCP is the emerging standard for agent-tool communication. Argent requires no custom agent harness — just `argent init` and the agent discovers all capabilities. # quick start
Your first command
$
npx @swmansion/argent init$
npm install -g @swmansion/argent && argent init$
argent update●
Ready. Run --help to explore. # use cases
How developers use Argent
01
Autonomous bug reproduction on simulators
Ask your agent to reproduce a bug report — Argent launches the app, navigates the UI, reads console logs, and captures crash reports automatically.
02
Performance profiling and optimization
Agents can record React and native iOS profiles simultaneously, trace slow commits to native stack frames, detect UI hangs and render cascades.
03
Manual QA automation
Let agents step through test flows, swipe, type, and tap through screens while logging every interaction and screenshot.
04
CI-adjacent diagnostics
Use in development workflows to let agents diagnose simulator failures, inspect network requests, and read native logs without leaving the terminal.
# comparison
How Argent compares
Choose Argent for mobile-specific agent workflows vs general-purpose browser agent tools
browser-use and OpenClaw focus on web browser control. Argent is purpose-built for iOS Simulator and Android Emulator control, including deep diagnostics and profiling.
Choose Argent for simulator control vs React Native Agent Skills
React Native Agent Skills provides instructions for agents working on RN projects. Argent is a runtime toolkit that actually controls the simulator — they complement each other.
Deeper than screencap-based approaches vs screenshot-and-click agent tools
Argent uses accessibility trees and direct simulator protocols instead of screen coordinates from screenshots, making interactions more reliable and context-efficient.
# faq
Questions
Q: What should I check before using Argent?
You need macOS with Xcode for iOS simulator control, or Android SDK Platform Tools (adb) for Android. Argent runs on Node.js 18+. Review the mixed-license model before production use.
Q: Is Argent open source?
Argent uses a mixed licensing model. Source code is Apache 2.0. Proprietary binaries (simulator-server, ax-service, and native .dylib files) are licensed solely for use within this project.
Q: Which coding assistants does Argent support?
Argent works with Claude Code, Cursor, GitHub Copilot, OpenAI Codex, Google Gemini, OpenCode, Windsurf, and Zed — any agent that can run shell commands and supports MCP.
Decision brief
JSON
Should you use Argent?
- Users who only develop for web or backend and never touch mobile simulators
- Teams that cannot install macOS with Xcode (iOS) or Android SDK Platform Tools (Android)
- Verified 2026-06-03
- License: Apache-2.0 with proprietary binaries
- Repo: software-mansion/argent
- Open-source status needs review
Deployment
cloud
Permission surface
shell/files, memory, external services
Decision signals
MCP
Agent packet
Structured decision data for Argent
This packet is the compact machine-readable view agents should use before following source links or taking action.
Capabilities
tool calling, mcp, workflow orchestration
Constraints
source available, mcp compatible
Deployment
cloud
Permission surface
shell/files, memory, external services
Recommended workflows
Browser automation, Coding agent workflow, Connector or protocol layer
Overview
What Argent does
What it is
Argent is an MCP-native toolkit that connects AI coding assistants to iOS Simulators and Android Emulators. It provides a full suite of capabilities: UI interaction (tap, swipe, pinch, type, gestures, hardware buttons), debugging (console logs, view hierarchy, network requests, React component tree), and profiling (React and Xcode Instruments sessions). It auto-detects editors like Claude Code, Cursor, Codex, Gemini, OpenCode, Windsurf, and Zed, and registers itself as an MCP server at `argent init`.
Why it matters
Mobile development feedback loops are slow. Build → switch to simulator → reproduce → switch back → fix. Argent closes that loop by letting agents operate the simulator directly. Instead of describing what the agent should do, you tell it what you want, and Argent handles reproduction, diagnostics, and profiling. For React Native teams, this is especially powerful — Argent works natively with RN projects so agents can build, launch, and iterate without extra setup.
How to evaluate it
Argent runs as an MCP stdio server. After `npx @swmansion/argent init`, your agent discovers Argent's tools automatically. The toolkit talks to simulators directly via `simulator-server` (iOS) and `adb` (Android), bypassing slow XCUITest-based approaches. Every interaction returns structured feedback so the agent knows screen state. For profiling, it runs React and native profiles concurrently and can answer multiple questions from one profiling session without re-running it.
Facts
Known metadata and operating surface
These fields are separated from editorial interpretation so agents can reason over facts and missing checks.
Resource type agent
Category Agents
Maturity active
Difficulty Unknown
License Apache-2.0 with proprietary binaries
Pricing free
Verified 2026-06-03
Source confidence high
Risk level elevated
Fit matrix
Where Argent fits in an agent stack
strong
Browser automation
Argent has multiple signals for browser automation, including matching tags, capabilities, category, or positioning.
- Run one non-sensitive website task and inspect clicks, waits, retries, and changed URLs.
- Confirm official docs, current maintenance, license, and runtime constraints before production use.
strong
Coding agent workflow
Argent has multiple signals for coding agent workflow, including matching tags, capabilities, category, or positioning.
- Run a small repository change and inspect the diff, tests, and rollback path.
- Confirm official docs, current maintenance, license, and runtime constraints before production use.
strong
Connector or protocol layer
Argent has multiple signals for connector or protocol layer, including matching tags, capabilities, category, or positioning.
- Connect one low-risk service, then inspect schemas, auth scope, errors, and logs.
- Confirm official docs, current maintenance, license, and runtime constraints before production use.
partial
Evaluation and observability
Argent has at least one signal for evaluation and observability, but should be checked against a real task before adoption.
- Add one repeatable test case and confirm results can run again in review or CI.
- Confirm official docs, current maintenance, license, and runtime constraints before production use.
partial
Memory or RAG workflow
Argent has at least one signal for memory or rag workflow, but should be checked against a real task before adoption.
- Create, update, retrieve, correct, and delete memory or retrieval objects with real data.
- Confirm official docs, current maintenance, license, and runtime constraints before production use.
partial
Reusable skill workflow
Argent has at least one signal for reusable skill workflow, but should be checked against a real task before adoption.
- Run one skill end to end and check whether it produces evidence or structured output.
- Confirm official docs, current maintenance, license, and runtime constraints before production use.
Inputs and outputs
What an agent should inspect
Likely inputs
- Repositories, files, issues, terminal output, and test results
- Tool schemas, API requests, service resources, and auth scopes
- Official setup instructions and a small real workflow
Likely outputs
- Diffs, commits, explanations, test results, or review notes
- A decision on whether this resource fits the target workflow
Evidence
Sources, claims, and missing checks
Claims are marked separately from source links so future crawlers and reviewers can update them without rewriting the page.
GitHub github
Repository source for code, license, issues, releases, and implementation details.
Homepage homepageOfficial or project-controlled source for this resource profile.
Source npmOfficial or project-controlled source for this resource profile.
Argent is not currently marked as open source in OpenAgent metadata.
License metadata: Apache-2.0 with proprietary binariesArgent has a recorded GitHub repository: software-mansion/argent.
Resource facts and GitHub source link.Argent supports these recorded deployment modes: cloud.
OpenAgent decision signal metadata.Argent is tagged with tool calling, mcp, workflow orchestration capabilities.
OpenAgent capability taxonomy.- Dedicated docs link is missing.
- Repository freshness has not been recorded.
Next action
How to start evaluating Argent
Inspect repository
Check license, recent activity, issues, examples, and security-sensitive code paths.
Open sourceOpen Homepage
Start from the official source before adopting third-party instructions.
Open sourceOpen Source
Start from the official source before adopting third-party instructions.
Open sourceInstall Argent via npx
Run from your project root. The init wizard installs the package globally, detects your editor, and registers the MCP server automatically.
npx @swmansion/argent initInstall Argent globally
Alternative manual install path for global setup.
npm install -g @swmansion/argent && argent init Compare
Alternatives and nearby resources
Use related resources to compare category fit, license, deployment model, and first-workflow behavior.
FAQ
Common questions about Argent
What should I check before using Argent?
You need macOS with Xcode for iOS simulator control, or Android SDK Platform Tools (adb) for Android. Argent runs on Node.js 18+. Review the mixed-license model before production use.
Is Argent open source?
Argent uses a mixed licensing model. Source code is Apache 2.0. Proprietary binaries (simulator-server, ax-service, and native .dylib files) are licensed solely for use within this project.
Which coding assistants does Argent support?
Argent works with Claude Code, Cursor, GitHub Copilot, OpenAI Codex, Google Gemini, OpenCode, Windsurf, and Zed — any agent that can run shell commands and supports MCP.
Does Argent work on Android?
Yes. Argent supports both iOS Simulators and Android Emulators, including UI interaction, debugging, and profiling.
What makes Argent different from XCUITest or Appium?
XCUITest requires switching between test runner and app for every action. Argent talks to the simulator directly, making interactions faster and more suitable for agent loops. It also includes profiling and diagnostics that those tools do not offer.
Is Argent free?
Yes, Argent is free to use and published on npm as @swmansion/argent.