{
  "markdown": "# ipsw-skill\n\nAn AI agent skill for Apple firmware and binary reverse engineering using the [ipsw](https://github.com/blacktop/ipsw) CLI tool.\n\nSupports **Claude Code**, **Codex CLI**, **Gemini CLI**, and **Pi (pi-coding-agent)**.\n\n## What This Skill Provides\n\nThis skill empowers AI agents to assist with:\n\n- **Downloading/extracting firmware** - IPSWs, OTAs, kernelcaches, dyld_shared_cache\n- **Userspace reverse engineering** - DSC disassembly, symbol lookup, xrefs, string search\n- **Dumping Objective-C headers** from private frameworks\n- **Kernel & KEXT analysis** - extraction, syscalls, diffing between versions\n- **Entitlements research** - database queries, capability discovery\n- **Mach-O binary analysis** - signatures, entitlements, disassembly\n\n## Installation\n\n### Prerequisites\n\nInstall the `ipsw` CLI tool:\n\n```bash\nbrew install blacktop/tap/ipsw\n```\n\n### skills.sh\n\n```bash\nnpx skills add https://github.com/blacktop/ipsw-skill --skill ipsw\n```\n\n### Claude Code\n\nInstall from marketplace:\n\n```bash\nclaude plugin marketplace add blacktop/ipsw-skill\nclaude plugin install ipsw\n```\n\nOr install manually:\n\n```bash\ngit clone https://github.com/blacktop/ipsw-skill /tmp/ipsw-skill\n\n# User-wide (available in all projects)\nmv /tmp/ipsw-skill/ipsw ~/.claude/skills/ipsw\n\n# Project-specific (check into your repo)\nmv /tmp/ipsw-skill/ipsw .claude/skills/ipsw\n```\n\n### Codex CLI\n\nUse the built-in installer:\n\n```bash\n$skill-installer https://github.com/blacktop/ipsw-skill --path ipsw\n```\n\nOr install manually:\n\n```bash\ngit clone https://github.com/blacktop/ipsw-skill /tmp/ipsw-skill\n\n# User-wide\nmv /tmp/ipsw-skill/ipsw ~/.codex/skills/ipsw\n\n# Project-specific\nmv /tmp/ipsw-skill/ipsw .codex/skills/ipsw\n```\n\n> **Note**: Run Codex with `--enable skills` if skills aren't loading automatically.\n\n### Gemini CLI\n\nInstall the extension directly:\n\n```bash\ngemini extensions install https://github.com/blacktop/ipsw-skill\n```\n\n### Antigravity\n\nInstall the skill manually:\n\n```bash\n# User-wide\nmv /tmp/ipsw-skill/ipsw ~/.gemini/antigravity/skills/ipsw\n\n# workspace-specific\nmv /tmp/ipsw-skill/ipsw <workspace-root>/.agent/skills/ipsw\n```\n\n### Pi (pi-coding-agent)\n\n```bash\n# Global (adds package to ~/.pi/agent/settings.json; clones to ~/.pi/agent/git/...)\npi install https://github.com/blacktop/ipsw-skill\n\n# Project-local (adds package to ./.pi/settings.json; clones to ./.pi/git/...)\npi install -l https://github.com/blacktop/ipsw-skill\n```\n\n## Usage Examples\n\nOnce installed, the agent will automatically use this skill for Apple RE tasks:\n\n> \"Download the latest IPSW for iPhone 15 Pro and extract the kernel\"\n\n> \"Disassemble the _malloc function from the system dyld_shared_cache\"\n\n> \"Dump the Objective-C headers for SpringBoardServices\"\n\n> \"Find all binaries with the platform-application entitlement in iOS 18\"\n\n> \"What address is -[NSObject init] at in the DSC?\"\n\n> \"Find all xrefs to this function address\"\n\n## Contents\n\n```\nipsw-skill/\n├── ipsw/                       # The skill (Claude Code / Codex / Gemini all read this)\n│   ├── SKILL.md                # Main skill instructions\n│   └── references/\n│       ├── dyld.md             # DSC analysis (a2s, xref, dump, str)\n│       ├── download.md         # Firmware download & extraction\n│       ├── kernel.md           # Kernel & KEXT analysis\n│       ├── macho.md            # Mach-O binary analysis\n│       ├── class-dump.md       # ObjC header dumping\n│       └── entitlements.md     # Entitlements database & queries\n├── gemini-extension.json       # Gemini extension config\n├── package.json                # Pi package manifest\n└── .claude-plugin/\n    └── marketplace.json        # Claude marketplace config\n```\n\n## Resources\n\n- [ipsw Documentation](https://blacktop.github.io/ipsw)\n- [ipsw GitHub](https://github.com/blacktop/ipsw)\n- [Discord Community](https://discord.gg/BEamsHAWAh)\n\n## License\n\nMIT\n",
  "bytes": 3874,
  "sha": "31b3933b7fbfa382888ab26feaf51b534454a476fd4d22facabd0094cf011795",
  "repo_slug": "blacktop/ipsw-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_blacktop_ipsw_skill_596d7304/readme"
}