Skillget

atomyx

mcp
Security Audit
Fail
Health Warn
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Fail
  • rm -rf — Recursive force deletion command in apps/studio/src-tauri/helpers/atomyx-sim-capture/build.sh
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

AI agents that test mobile apps. Your agent thinks in user actions - open the app, tap the button, type the email, verify the screen. Atomyx handles the platform

README.md

Atomyx

AI agents driving real mobile apps — cross-platform, selector-first,
open source.

License
Status
Node

Atomyx lets an AI agent drive iOS and Android apps the way a human QA
would — discover screens, try flows, report bugs — through a small,
stable set of high-intent tools. The same agent code drives both
platforms; device selection, selector resolution, scroll-into-view,
and z-order obscurement checking are handled for you.

By Solrum · Apache 2.0.

What it feels like

format: atomyx/v1
appId: com.android.settings
name: Settings smoke test
---
- launchApp
- tap: "Connections"
- waitFor: "Wi-Fi"
- screenshot: connections_screen
- back

One YAML, same script for iOS and Android. An agent can also call the
same underlying primitives through the MCP tool surface — the two
front-ends share one Driver port.

Status

Pre-1.0 (current: v0.1.0).

Platforms

OS State
Android (device + emulator) Preview
iOS (simulator + physical device) Preview
Web (browser) Planned

App UI frameworks

Framework State
Native Android (Views + Jetpack Compose) Preview
Native iOS — UIKit Preview
Native iOS — SwiftUI Preview (verified against Apple system apps only; custom SwiftUI apps untested)
Flutter Preview — known edge cases (custom keypads, unreliable clickable flag)
React Native Untested — bug reports welcome

Features

Feature State
MCP tool surface (27 tools) Preview
YML script engine (17 commands) Preview
API capture (mitmproxy integration) Preview
Unified atomyx mcp binary Planned for v1.0 (today: use atomyx-mcp)
npm / GitHub Packages release Planned for v1.0

Setup

git clone https://github.com/solrum/atomyx.git
cd atomyx
npm run setup   # installs dependencies and git hooks

Verify the install by running the fast quality gate:

npm run check:fast   # lint + typecheck + prefix + phrases — should pass

This sets up the TypeScript packages only. Native toolchains for
Android and iOS require additional steps — see
.claude/docs/android.md and
.claude/docs/ios.md.

For a full walkthrough — MCP client config, device prerequisites,
first test — see docs/getting-started.md.

Documentation

Audience Entry point
End users (install, run, script) docs/
Contributors (architecture, internals, pitfalls) .claude/docs/
YAML script authors docs/yml-script-reference.md
Device setup (Android + iOS) docs/device-setup.md

Contributing

Issues and PRs welcome. Start with
.claude/docs/development.md for
build, test, and extension workflows; and
.claude/docs/architecture.md for
the design contract.

License

Apache 2.0. See LICENSE.

Reviews (0)

No results found