Argent

npx @swmansion/argent@latest init # or, in a pnpm project (where npm's devEngines check may refuse to run npx): pnpm dlx @swmansion/argent@latest init

Argent drives a growing set of targets through a single toolkit, each with the right interaction model - touch, remote or mouse:

Tip:Once installed, ask your assistant"What can Argent do?"- it will walk you through all capabilities available.

- Node.js 20.12or later
- For iOS / tvOS: macOS withXcodeinstalled (Apple TV uses tvOS simulators — Xcode downloads the tvOS runtime on demand)
- For Android / Android TV:Android SDK Platform Tools(adb) onPATH, and theAndroid Emulatorpackage if you want to boot AVDs from Argent. Create AVDs via Android Studio oravdmanager.
- For Fire TV (Vega): theVega SDK(vegaCLI) onPATH
- For Electron / Chromium: nothing extra to control an already-running app - just launch it with--remote-debugging-port, or let Argent spawn your Electron app for you

Argent runs Android emulators on Linux but the default install can be slow if a few host-side knobs aren't right. Cover these once and the experience matches macOS:

-

KVM access.The emulator falls back to slow software emulation (TCG) without/dev/kvm. Make sure virtualization is enabled in BIOS/UEFI (vmxfor Intel,svmfor AMD in/proc/cpuinfo) and that your user can read/write/dev/kvm— on most distros that means joining thekvmgroup:

sudo usermod -aG kvm "$USER" # log out and back in so the new group takes effect

GPU mode (-gpu swiftshaderon Linux, override available).The Android emulator's Linux GPU story is messy:-gpu autofrequently resolves to lavapipe (slow software Vulkan via host libvulkan, ~10× cold-boot regression on flagship hardware), and-gpu hostsilently produces a corrupted or black emulator window on hosts with non-trivial GL stacks — dual-GPU / Optimus laptops, NVIDIA + Mesa coexistence via libglvnd, Wayland sessions on hybrid graphics, headless / containerized hosts. The failure mode is invisible to argent's framebuffer-based screenshot tool, so an agent reports success while the developer sees a black window.

Argent picks-gpu swiftshaderon Linux for universal compatibility: it sidesteps the host GL stack entirely and renders via the emulator's bundled SwiftShader. On modern multi-core machines this is indistinguishably smooth from hardware-accelerated-gpu host(and far faster than lavapipe).

Override with theARGENT_EMULATOR_GPU_MODEenv var if you've verified-gpu hostworks on your machine (typical single-GPU Mesa box with a healthy X session):

ARGENT_EMULATOR_GPU_MODE=host argent ...

Argent's boot-device preflight prints a warning if/dev/kvmisn't usable — the condition that causes a 10–50× TCG-vs-KVM slowdown.

System image.Prefer thedefaultorgoogle_apisvariants ofx86_64system images for headless agent workflows;google_apis_playstoreadds noticeable boot-time CPU churn from Play services. Always pickx86_64on Intel/AMD hosts — ARM images run via QEMU translation and are dramatically slower.

AVD config.AVDs created viaavdmanager create avddefault tohw.gpu.enabled=no. Argent overrides this with an explicit-gpuarg at launch (so the on-disk config doesn't need editing). For the smoothest experience under heavy native builds (gradle compilations alongside the AVD), bump the AVD's RAM and CPU count — edit~/.android/avd/<name>.avd/config.ini:

hw.ramSize = 8192 hw.cpu.ncore = 6 vm.heapSize = 512

Stock 2 GB / 4 vCPU AVDs can be CPU-starved into wedged-system_server states by a concurrent gradle/Kotlin compile.

Headless / CI mode (ARGENT_EMULATOR_NO_WINDOW=1).Argent shows the emulator window by default so a local developer can see the AVD UI. In a headless context — CI runner, container, or a Wayland-only session where the emulator's bundled Qt has nowaylandplatform plugin and SIGABRTs on the crash-consent dialog — opt out by exportingARGENT_EMULATOR_NO_WINDOW=1before starting the tool-server. This appends-no-windowto the spawn args, selectingqemu-system-x86_64-headlesswhich doesn't need a Qt window. Argent's screencap-based screenshot tool reads the in-memory framebuffer correctly without a visible window.

npx @swmansion/argent@latest init # or, in a pnpm project (where npm's devEngines check may refuse to run npx): pnpm dlx @swmansion/argent@latest init

This command triggers an installation wizard which:

- Installs@swmansion/argentglobally
- Detects your editor and registers the MCP server
- Copies skills, rules, and agent definitions into your workspace

npm install -g @swmansion/argent argent init

Share Argent with your team (committable install)

By default Argent installsglobally. To version Argentwith your reposo every teammate gets the same setup onnpm install— no per-developer global install, noargent init— choose the local mode:

npx @swmansion/argent@latest init --local # or, in a pnpm project: pnpm dlx @swmansion/argent@latest init --local

Note: in a freshlypnpm init-ed project,npxitself may refuse to run (npm'sdevEnginescheck) — use thepnpm dlxform there.

This adds@swmansion/argentto your project'sdevDependenciesand writes MCP configs that launch the project-local copy (node node_modules/@swmansion/argent/dist/cli.js mcp). Commitpackage.json+ your lockfile, the generated MCP config (.mcp.json,.cursor/mcp.json, …),.argent/install.json, and the skills/rules/agents files. Teammates then just runnpm install.

Pass--globalto force the default mode in scripts;--localand--globalare mutually exclusive. A non-interactive (--yes) run defaults to global unless the project already opted into local mode (a committed.argent/install.json, or@swmansion/argentdeclared in the project's ownpackage.json).

In local mode the committed MCP config runs the project-local copy, so the bareargentcommand isnoton teammates'PATH. Note thatnpm installbuilds Argent's native deps (tree-sitter) on each machine — prebuilt for macOS, Linux x64, and Windows x64; other targets (Linux arm64, Windows arm) compile from source and need a C/C++ toolchain.

argent initauto-detects and configures MCP for:

Argent collects opt-out usage and diagnostic telemetry to help us prioritise features and fix what breaks.

argent telemetry disable # check status with: argent telemetry status

Proprietary binaries(the per-platformbin/<platform>/simulator-serverandbin/darwin/ax-serviceexecutables and the.dylibfiles innative-devtools-ios) are the intellectual property of Software Mansion S.A. and are licensed solely for use within this project. Decompiling, reverse-engineering, or redistributing them without explicit written permission is prohibited.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Drives an Android emulator or a real device over adb: screenshots, UI hierarchy with true device-pixel coordinates, tap and type, app lifecycle, logcat, and Gradle builds and tests.

Control Android devices via the Android Debug Bridge (ADB).

The deepest Android Debug Bridge MCP server — 147 tools from UI to baseband.

Proxyman MCP allows AI to inspect HTTP traffic, create debugging rules, and control Proxyman - all through natural language conversations.

Interact with Android devices using the Android Debug Bridge (ADB).

Interact with Android devices using the Android Debug Bridge (ADB).

AI 測試大師 — MCP server driving pytest / Jest / Cypress / Go / Maestro. Analyze, generate, run, advise. Web + Mobile (iOS/Android/BlueStacks).

Control Android devices using the Android Debug Bridge (ADB).

Automate Android devices using the Gbox SDK.