ios-reverse-engineering-skill iOS Reverse & Tweak Engineering Suite

iOS Reverse & Tweak Engineering Suite

Decompile Mach-O binaries. Triage FairPlay DRM. Recover stripped Swift & Objective-C symbols. Instrument runtimes with Frida & LLDB. Safely patch ARM64 opcodes and engineer iOS tweaks.

An enterprise-grade, modular toolkit for iOS app reverse engineering, IPA decompilation, dynamic instrumentation, and binary modification across iOS, iPadOS, and macOS Catalyst binaries. Conforms to the ASD-STE100 (Simplified Technical English) standard for precision and reliable AI agent orchestration.

View on GitHub skills.sh Listing Installation Guide

Capabilities

DomainCapabilityDescription
DRM & TriagePhase 0: DRM & FingerprintFast container triage (IPA, APP, DYLIB, FRAMEWORK), architectures, FairPlay encryption status (cryptid == 0 vs 1), runtime mix, framework stack (Native, Flutter, React Native, Unity), ATS posture, and third-party SDK census.
Static AnalysisMach-O TeardownExhaustive Mach-O parsing: load commands, segments/sections, linked libraries, code signature SuperBlobs, entitlement keys, and Info.plist properties.
Symbol RecoveryStripped Binary RecoveryRebuild Objective-C and Swift symbol tables from __objc_methname, __objc_classname, __objc_selrefs, and __swift5_reflstr. Reconstruct binary symbol tables via restore-symbols.
DecompilationHeadless Ghidra AutomationBatch decompilation with 8 bundled headless scripts: SwiftDemangler, DetectSwizzling, ExportAPICalls, ExportCryptoUsage, ExportStringXrefs, and FindSecrets.
Dynamic AnalysisFrida & LLDB InstrumentationUniversal SSL unpinning (Security.framework, BoringSSL, TrustKit), live keychain dumping, call hierarchy method tracing, and runtime method swizzling detection.
Binary PatchingARM64 Verified PatchingCalculate PC-relative offsets (ADRP + ADD/LDR) with find_refs.py. Safely patch Mach-O instructions with expected-byte verification using patch_macho.py.
Tweak EngineeringLinkage & InjectionInspect tweak load commands, rpaths, and hooking runtimes (inspect_tweak.py). Validate dyld structure with xcrun dyld_info -validate_only and inject into app bundles.
Apple InternalsLow-Level Knowledge BaseReference guides on dyld shared cache extraction, AMFI enforcement, CodeDirectory hashing, Trust Caches, Mach IPC, and IOKit userclients.
API ExtractionEndpoint & Secret ScanExtract REST and GraphQL endpoints, WebSocket URLs, auth token schemas, and cloud credentials in structured Tier 1 (flat inventory) and Tier 2 (deep dive) schemas.

Guides and Documentation

Decompile an IPA

Unpack, inspect Mach-O slices, and execute headless Ghidra native decompilation.

Tweak Engineering & Patching

ARM64 PC-relative math, opcode patching, dyld verification, and xkvm tweak injection.

Dynamic Instrumentation

Universal Frida SSL unpinning, live keychain dumpers, and LLDB breakpoint recipes.

FairPlay DRM Triage

Detect cryptid encryption states and execute on-device application decryption.

Recover Swift & ObjC Symbols

Reconstruct stripped release binaries from reflection strings and runtime metadata.

Mach-O Architecture Teardown

Deep-dive into Mach-O 64-bit headers, load commands, sections, and entitlements.

Apple Internals & AMFI

Mach kernel IPC, CodeDirectory SuperBlobs, Trust Caches, and Dyld Shared Cache.

Extract Backend APIs

Map REST, WebSocket, and GraphQL endpoints, headers, and hardcoded credentials.

Installation

Install via universal agent skill package manager (skills.sh):

npx skills add Laurent-xscope/ios-reverse-engineering-skill

Or install as a Claude Code plugin directly from GitHub:

/plugin marketplace add Laurent-xscope/ios-reverse-engineering-skill
/plugin install ios-reverse-engineering@ios-reverse-engineering-skill

Quick Start Workflow

Fingerprint the target binary architecture, runtime mix, and third-party frameworks:

bash scripts/fingerprint.sh App.ipa

Verify FairPlay DRM encryption status:

bash scripts/check-encryption.sh App.ipa

Perform complete Mach-O teardown with headless Ghidra decompilation:

bash scripts/teardown.sh --arch arm64 --decompile App.ipa

Resolve ARM64 PC-relative (ADRP + ADD/LDR) string or address references:

python3 scripts/tweak/find_refs.py -b App.app/App -s "isProSubscriptionActive"

Apply safe byte-verified patch to return TRUE (mov w0, #1; ret):

python3 scripts/tweak/patch_macho.py -b App.app/App -o 0x145a20 -e "e0031faac0035fd6" -r "20008052c0035fd6" --backup

Run dynamic Frida instrumentation with universal SSL unpinning:

bash scripts/dynamic/run_dynamic.sh -t com.example.app -m ssl

Frequently Asked Questions

How do I decompile an iOS IPA file?

Execute bash scripts/teardown.sh app.ipa. The suite extracts the archive, selects the arm64 binary, parses all Mach-O load commands, executes headless Ghidra decompilation, and exports 19 structured reports covering headers, symbols, entitlements, and endpoints.

How do I recover Swift and Objective-C names from stripped binaries?

App Store release builds strip the symbol table (LC_SYMTAB) but keep runtime metadata in __objc_classname, __objc_methname, and __swift5_reflstr. Run bash scripts/recover-names.sh binary names_dir to index real symbols or bash scripts/restore-symbols.sh binary to rebuild the symbol table.

How do I bypass iOS SSL pinning?

Run bash scripts/dynamic/run_dynamic.sh -t <bundle_id> -m ssl. The suite injects a battle-tested universal Frida hook targeting Security.framework, BoringSSL, AFNetworking, TrustKit, and NSURLSession delegates.

How do I calculate ARM64 ADRP and ADD PC-relative instruction offsets?

ARM64 instructions use PC-relative page addressing rather than absolute 64-bit pointers. Run python3 scripts/tweak/find_refs.py -b binary -s "search_string" to automatically compute ADRP page bases and ADD/LDR immediate offsets down to exact file offsets for binary patching.

How do I safely patch a Mach-O binary without crashing at launch?

Use python3 scripts/tweak/patch_macho.py -b binary -o <offset> -e <expected_hex> -r <replacement_hex>. The tool validates existing disk bytes before patching, preserves entitlements, re-signs ad-hoc, and runs xcrun dyld_info -validate_only to ensure structural integrity.

How do I check FairPlay DRM encryption?

Run bash scripts/check-encryption.sh app.ipa. The script examines LC_ENCRYPTION_INFO and LC_ENCRYPTION_INFO_64. If cryptid is 1, the binary is encrypted by Apple FairPlay and must be dumped from a live jailbroken or decrypted device before static analysis.