Skip to content
Back to search

Mira

Mobile runtime detection workbench for AI (iOS and Android)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/vw2x/Mira with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/vw2x/Mira'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/vw2x--mira/badge.svg)](/listings/vw2x--mira)

HTML

<a href="/listings/vw2x--mira"><img src="/api/listings/vw2x--mira/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

- **Relay**: `PYTHONPATH=. python3 -m mira.relay.server --host 0.0.0.0 --port 8765 --advertise-url http://<your-lan-ip>:8765` - **Browser**: Open `http://127.0.0.1:8765` on your desktop. - **Android**: [Download the latest APK](https://github.com/vwww-droid/Mira/releases/latest/download/mira-app-debug.apk), install it, then enter `http://<your-lan-ip>:8765` in the app. - **iOS**: Verified on a real device running iOS 16.7.10. See [`docs/GETTING-STARTED.md`](./docs/GETTING-STARTED.md). - **AI**: `PYTHONPATH=. python3 -m mira.mcp.server --relay http://127.0.0.1:8765`. MCP config: [`docs/MCP.md`](./docs/MCP.md).

The APK's offline Python/Frida runtime requires arm64-v8a and supports Android 10 through 15. Android 16 Java hooks are not supported, and no confirmed official Frida fix is available. See the [compatibility notes](./docs/notes/android-frida-gadget-compatibility-2026-09-05.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 121 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="right">
  2. English | <a href="./README.zh-CN.md">简体中文</a>
  3. </p>
  4. <div align="center">
  5. <img src="./docs/mira-readme-icon-round.png" alt="Mira icon" width="138" />
  6. # Mira
  7. Mobile runtime detection workbench for iOS and Android.
  8. <p>
  9. <img src="https://img.shields.io/badge/analysis-AI--native-0f172a?style=flat-square" alt="AI-native analysis" />
  10. <img src="https://img.shields.io/badge/platform-Android%20%2B%20iOS-2f855a?style=flat-square" alt="Android and iOS" />
  11. <img src="https://img.shields.io/badge/execution-live%20logic-2563eb?style=flat-square" alt="Live logic execution" />
  12. <img src="https://img.shields.io/badge/workflow-Relay%20%2B%20MCP-7c3aed?style=flat-square" alt="Relay and MCP" />
  13. </p>
  14. </div>
  15. ## Why follow Mira
  16. Mira turns real runtime cases into reusable workflows, tools, and detection notes.
  17. ## Research Updates
  18. - [260520] Article: [Detecting root, emulators, and scrcpy-like projection through the audit logcat side channel](./knowledge/articles/en/audit-logcat-sidechannel-detect-root-emulator-projection.md)
  19. - [260520] Case: [Android high-PID shell proc audit side-channel hints at scrcpy projection](./knowledge/cases/en/2026/2026-05-20-android-high-pid-shell-audit-sidechannel-scrcpy.md)
  20. - [260520] Case: [Android emulator proc audit side-channel exposes qemu SELinux context](./knowledge/cases/en/2026/2026-05-20-android-emulator-proc-audit-sidechannel.md)
  21. - [260519] Case: [Android proc audit side-channel detects Magisk SELinux context](./knowledge/cases/en/2026/2026-05-19-android-proc-audit-magisk-sidechannel.md)
  22. ## Features
  23. - **App sandbox tools**: Use shell, PTY, screen capture, and file tools inside the Mira host app sandbox on Android and iOS.
  24. - **Frida tasks**: Run Java and native hooks with RPC for one-time runtime analysis.
  25. - **Relay and MCP**: Connect devices through Relay and let AI work in the same sessions through MCP.
  26. ## Getting Started
  27. - **Relay**: `PYTHONPATH=. python3 -m mira.relay.server --host 0.0.0.0 --port 8765 --advertise-url http://<your-lan-ip>:8765`
  28. - **Browser**: Open `http://127.0.0.1:8765` on your desktop.
  29. - **Android**: [Download the latest APK](https://github.com/vwww-droid/Mira/releases/latest/download/mira-app-debug.apk), install it, then enter `http://<your-lan-ip>:8765` in the app.
  30. - **iOS**: Verified on a real device running iOS 16.7.10. See [`docs/GETTING-STARTED.md`](./docs/GETTING-STARTED.md).
  31. - **AI**: `PYTHONPATH=. python3 -m mira.mcp.server --relay http://127.0.0.1:8765`. MCP config: [`docs/MCP.md`](./docs/MCP.md).
  32. The APK's offline Python/Frida runtime requires arm64-v8a and supports Android 10 through 15. Android 16 Java hooks are not supported, and no confirmed official Frida fix is available. See the [compatibility notes](./docs/notes/android-frida-gadget-compatibility-2026-09-05.md).
  33. ## Architecture
  34. - [Android application architecture and Java/C boundaries](./docs/ANDROID-ARCHITECTURE.md)
  35. - [Shared native PTY architecture](./docs/NATIVE-ARCHITECTURE.md)
  36. - [Repository layout](./docs/REPO-ARCHITECTURE.md)
  37. ## Contributing
  38. Mira welcomes issues and pull requests from mobile security researchers, reverse engineers, Frida users, MCP users, and device testers.
  39. - Read [`CONTRIBUTING.md`](./CONTRIBUTING.md) before opening a focused pull request.
  40. - Use the issue templates for bugs, security hardening, detection ideas, and device compatibility reports.
  41. - For security reports, read [`SECURITY.md`](./SECURITY.md) first.
  42. - Scanner-generated hardening PRs are welcome when they include repository-specific reachability reasoning and verification.
  43. Good starting points include native memory-safety review, Android and iOS device testing, Frida workflow examples, MCP client setup notes, and new reusable detection cases.
  44. ## Live Discovery Examples
  45. <table>
  46. <tr>
  47. <th align="center">Android Remote Frida</th>
  48. <th align="center">iOS Remote Frida</th>
  49. </tr>
  50. <tr>
  51. <td>
  52. <img src="./docs/android-remote-frida.png" alt="Android Remote Frida" />
  53. <div align="center"><sub>Remote shell, runtime inspection, and live Frida execution on Android.</sub></div>
  54. </td>
  55. <td>
  56. <img src="./docs/ios-remote-frida.png" alt="iOS Remote Frida" />
  57. <div align="center"><sub>Equivalent PTY and Frida workflow adapted to the iOS iSH compatibility layer.</sub></div>
  58. </td>
  59. </tr>
  60. <tr>
  61. <th align="center">Android LSPosed Trace</th>
  62. <th align="center">iOS Jailbreak Trace</th>
  63. </tr>
  64. <tr>
  65. <td>
  66. <img src="https://github.com/vwww-droid/Mira/releases/download/v1.1.2/Area.preview.gif" alt="Android LSPosed Trace" />
  67. <div align="center"><sub><a href="https://github.com/vwww-droid/Mira/releases/download/v1.1.2/Area.gif">Download original GIF</a></sub></div>
  68. <div align="center"><sub>Construct a Frida path around the app classloader and surface LSPosed traces from runtime state.</sub></div>
  69. </td>
  70. <td>
  71. <img src="https://github.com/vwww-droid/Mira/releases/download/v1.1.2/cydia-ios.preview.gif" alt="iOS Jailbreak Trace" />
  72. <div align="center"><sub><a href="https://github.com/vwww-droid/Mira/releases/download/v1.1.2/cydia-ios.gif">Download original GIF</a></sub></div>
  73. <div align="center"><sub>Ask Claude to roam the live terminal and surface jailbreak-related traces in the device environment.</sub></div>
  74. </td>
  75. </tr>
  76. </table>
  77. ## Public Relay Access
  78. ![Relay exposed through cpolar](./docs/public-deploy.png)
  79. With Relay, you can temporarily expose an authorized session beyond the local network for cloud devices, expert review handoff, and fast evidence sharing.
  80. ## Research Boundaries
  81. 1. Mira observes and interacts with the Mira host app sandbox.
  82. 2. Mira does not control unrelated third-party apps.
  83. 3. Mira does not provide system-wide remote control.
  84. 4. Mira does not provide root or jailbreak bypass capabilities.
  85. 5. Mira is not a production SDK or a silent background control channel.
  86. ## Acknowledgements
  87. - [lamda](https://github.com/firerpa/lamda): inspiration for the web workbench interaction model.
  88. - [Termux](https://github.com/termux/termux-app): Android terminal UX and extensible shell ecosystem.
  89. - [iSH](https://github.com/ish-app/ish): iOS-side Linux shell compatibility and syscall translation path.
  90. ## License
  91. `GPL-3.0-only`.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.