Install the iOS Reverse Engineering Skill
Install for any agent that supports Agent Skills
npx skills add Laurent-xscope/ios-reverse-engineering-skill
The skills CLI installs the skill into every agent that it detects. The skill lives under plugins/ios-reverse-engineering/skills/ios-reverse-engineering/. The repo declares that path in skills.sh.json, so the CLI finds it.
Install as a Claude Code plugin
/plugin marketplace add Laurent-xscope/ios-reverse-engineering-skill
/plugin install ios-reverse-engineering@ios-reverse-engineering-skill
Install from a clone
git clone https://github.com/Laurent-xscope/ios-reverse-engineering-skill.git
cd ios-reverse-engineering-skill
/plugin marketplace add /path/to/ios-reverse-engineering-skill
/plugin install ios-reverse-engineering@ios-reverse-engineering-skill
Requirements
| Requirement | Needed | Why |
|---|---|---|
| macOS | Yes | The Apple tools read the Mach-O load commands |
| Xcode Command Line Tools | Yes | otool, nm, codesign, plutil, lipo, vtool, swift-demangle |
| Python 3 | Yes | The name recovery and the manifest build |
ipsw | Recommended | The Mach-O parser and the Objective-C class dumper |
| Ghidra | Recommended | The native decompile step |
jtool2 | Optional | The Mach-O header, segment, and entitlement views |
rizin | Optional | The class list, the libraries, the strings |
frida | Optional | The runtime instrumentation and the decrypted dump |
Check the dependencies
bash scripts/check-deps.sh
The checker prints the state of every tool and prints the machine-readable lines INSTALL_REQUIRED:<dep> and INSTALL_OPTIONAL:<dep>.
Install a missing tool
bash scripts/install-dep.sh ipsw
bash scripts/install-dep.sh ghidra
bash scripts/install-dep.sh frida-tools
On Windows with PowerShell:
& "scripts/install-dep.ps1" ipsw
The slash commands
/teardown path/to/app.ipa
/endpoints path/to/app.ipa
Troubleshooting
| Problem | Solution |
|---|---|
otool: command not found | Run xcode-select --install |
| The Ghidra step fails with a Java error | Set JAVA_HOME to a JDK 21 path |
The Ghidra step fails with a SIGBUS error | Set JAVA_HOME to another JDK |
ipsw asks for an architecture | Run lipo -thin arm64 <binary> -output <slice> first |
| The strings of an App Store binary look empty | The code is encrypted. Use frida-ios-dump. |
License
Apache-2.0. Ported from SimoneAvogadro/android-reverse-engineering-skill by Simone Avogadro.