Skip to main content
Glama
README.md
<br/>
<p align="center"><a href="https://argent.swmansion.com"><img width="1100" height="382" alt="argent-header" src="https://github.com/user-attachments/assets/6cec01d5-da3c-4b6c-97c3-0374a63c213c" /></a></p>

[![Ad](https://swm-delivery.com/www/images/zone-gh-argent-1?n=1)](https://swm-delivery.com/www/delivery/ck-slug.php?zoneid=zone-gh-argent-1&n=1)
[![Ad](https://swm-delivery.com/www/images/zone-gh-argent-2?n=1)](https://swm-delivery.com/www/delivery/ck-slug.php?zoneid=zone-gh-argent-2&n=1)
[![Ad](https://swm-delivery.com/www/images/zone-gh-argent-3?n=1)](https://swm-delivery.com/www/delivery/ck-slug.php?zoneid=zone-gh-argent-3&n=1)

**[Argent](https://argent.swmansion.com)** gives your AI assistant direct control of iOS simulators, Android emulators and devices, TVs (Apple TV, Android TV, Fire TV) and Electron/Chromium apps. Tap a button, profile a screen, reproduce a bug - without leaving the CLI.

```bash
npx @swmansion/argent@latest init  # pnpm: pnpm dlx @swmansion/argent@latest init
```

<p align="center"><img src="https://github.com/software-mansion/argent/blob/main/assets/showcase.gif" alt="argent showcase video gif" width="100%" /></p>

## What it does

- **Interact** - tap, swipe, gesture, type, hardware buttons; D-pad on TV; mouse and keyboard on desktop.
- **Flows** - record a path once, replay it deterministically as a repro or smoke test.
- **Visual regression** - diff a baseline against a live capture, OCR- and font-aware.
- **Profiling** - Hermes, React DevTools, Xcode Instruments, Perfetto: renders, CPU hotspots, hangs.
- **Debugging** - logs, network (`fetch` and native), JS evaluation, native and React trees.
- **React Native** - build, launch and iterate, no extra setup.

Ask your assistant _"What can Argent do?"_ to list every tool.

## Documentation

[Installation](https://docs.swmansion.com/argent/docs/fundamentals/installation) · [Platforms](https://docs.swmansion.com/argent/docs/fundamentals/supported-platforms) · [CLI](https://docs.swmansion.com/argent/docs/reference/cli) · [Editors](https://docs.swmansion.com/argent/docs/reference/editors)

## Privacy

Telemetry is opt-out: `argent telemetry disable`. See the [Privacy Notice](https://github.com/software-mansion/argent/blob/main/Telemetry.md).

## License

Argent uses a mixed licensing model. **Source code** is released under the [Apache License 2.0](LICENSE.txt). **Proprietary binaries** (the per-platform `bin/<platform>/simulator-server` and `bin/darwin/ax-service` executables and the `.dylib` files in `native-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. By using Argent, you acknowledge and agree to this structure. See [LICENSE](https://github.com/software-mansion/argent/blob/main/LICENSE.txt) for full details.

## Argent is created by Software Mansion

Since 2012 [Software Mansion](https://swmansion.com) is a software agency with experience in building web and mobile apps. We are Core React Native Contributors and experts in dealing with all kinds of React Native issues. We can help you build your next dream product – [Hire us](https://swmansion.com/contact/projects?utm_source=argent&utm_medium=readme).

[![swm](https://logo.swmansion.com/logo?color=white&variant=desktop&width=150&tag=argent-github "Software Mansion")](https://swmansion.com)

TDQS

A3.9/5.0

Scored across 77 tools

Disambiguation2/5

Multiple tools have unclear boundaries. The UI inspection cluster (describe, native-describe-screen, native-full-hierarchy, native-find-views, native-view-at-point, native-user-interactable-view-at-point, debugger-component-tree) has several close cousins, especially the two point-inspection tools and native-describe-screen vs describe. The typing cluster (keyboard, text, key, paste), the two network-log tools (view-network-logs vs native-network-logs), the CPU profiler queries (react-profiler-cpu-summary vs profiler-cpu-query), and the rotate vs gesture-rotate naming collision further compound the ambiguity, though the descriptions are detailed.

Naming Consistency3/5

Naming is consistent within clusters — gesture-*, native-*, debugger-*, flow-*, chromium-* — but the overall set mixes conventions: verb_noun (list-devices, boot-device), bare nouns (button, keyboard, text, key, describe), and inconsistent family naming (profiler-cpu-query vs react-profiler-cpu-summary). It remains readable, but there are notable deviations like debugger-component-tree and screen-recording-start vs screenshot.

Tool Count2/5

77 tools far exceeds the well-scoped range and is too many for the apparent scope, even though the server spans a broad platform (device automation, profiling, network, flows). The count is inflated by near-duplicate tools (multiple UI inspectors, CPU queries, and the keyboard/text/key split) and meta tools (update-argent, dismiss-update, gather-workspace-data). An agent faces an unwieldy surface to navigate.

Completeness4/5

The tool surface is remarkably comprehensive: device lifecycle, gestures, UI inspection, network capture, JS/native debuggers, React and native profilers, screen recording, permissions, and flow recording/replay are all covered. Minor gaps exist — no location simulation, biometrics, or device file push/pull — but agents can work around these, and core automation workflows have no dead ends.

Maintenance

ActivityActive
ResponsivenessWithin a week