Repository navigation
Proposal: ios-reverse-engineering — a static iOS app reverse engineering skill (Mach-O teardown, endpoint scan, stripped-binary name recovery) #2336
Laurent-xscope
started this conversation in
Ideas
Replies: 1 comment
|
Thanks for the detailed proposal, Laurent. Please open a draft PR with the complete bundle and link this discussion. Include the exact upstream commit, LICENSE and NOTICE, and a reproducible run on a sample you’re authorized to analyze. Please indicate which steps write reports, download dependencies, or invoke Ghidra so I can review those paths. |
0 replies
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
Proposal:
ios-reverse-engineering— an iOS app reverse engineering skillHi — I'd like to propose a new skill for the catalog: iOS app reverse engineering for AI agents.
Source: https://github.com/Laurent-xscope/ios-reverse-engineering-skill
License: Apache-2.0
Docs: https://laurent-xscope.github.io/ios-reverse-engineering-skill/
The task
An agent that receives an
.ipa,.app,.dylib, or.frameworkand needs to answer questions about it: what does the binary import, what are its capabilities, which HTTP endpoints does the app call, how is it authenticated, does it pin certificates, does it ship hardcoded secrets, and what are the real names of its functions in a stripped build.The gap in the current catalog
The catalog covers reverse engineering broadly, and the existing mobile entries are Android-focused or runtime-focused. As far as I can see there is no entry that reads a Mach-O binary statically and produces a name index plus an endpoint inventory.
jadxhas no Mach-O equivalent;class-dumpcovers Objective-C headers but not Swift, entitlements, segments, or endpoints;ipswparses Mach-O but does not do the analysis workflow.This is also the gap in the upstream project it is ported from: SimoneAvogadro/android-reverse-engineering-skill is the Android counterpart, and that project has no iOS sibling.
The complete bundle
Per the contributing guide, this bundle contains executable scripts, so it needs a maintainer review path. The complete bundle is:
What it does
manifest.json.DecompileAll.javawrites per-function C output.__objc_classname/__objc_methname/__objc_selrefsand__swift5_reflstr, resolves the two-hop selector pointer chain, demangles the Swift class names (_TtC7AlDente9Debouncer→AlDente.Debouncer), and produces an address → real-name index.UserDefaultsinstead of the Keychain.Safety
The scripts are read-only with respect to the target. They open an archive, read the binary, and write a report folder. No script sends a network request to the analyzed app, and no script reads credentials from the environment. The scripts do download tools from official upstream sources, but only in
install-dep.sh, and only when the user asks for a tool. The Ghidra step runs a bundled post-script that reads the imported program and writes text files.One usable example
Attribution
This is a port of SimoneAvogadro/android-reverse-engineering-skill by Simone Avogadro, which is Apache-2.0 licensed. The upstream project, Simone Avogadro, and the upstream contributors are credited in the port's
README.md,NOTICE, andLICENSEcopyright block. The port preserves the upstream workflow design, phase structure, two-tier endpoint documentation model, skill layout, and script naming; the iOS toolchain, the Mach-O teardown, the headless Ghidra step, the reflection-metadata name recovery, and the binary endpoint scan are new work.Why it belongs here
The catalog is the place where an agent looks for a reverse engineering skill. Today the answer for an iOS binary is "there isn't one". This fills that gap with a skill that runs entirely on a local macOS machine, needs no jailbreak, and produces evidence an agent can act on.
Happy to restructure the bundle, split it, rename it, or drop any part of it. Ready to send a PR in whatever form the maintainers prefer.
All reactions