Skip to content
Get packs

Hopper Binary Debugger

Lets an agent query Hopper Disassembler to inspect macOS/iOS binaries and debug runtime behavior.

Source Download skill
Repository
steipete/agent-scripts
Stars
7,433
Licence
MIT
Files
2 files

What it does

This skill teaches an AI agent how to use Hopper Disassembler, a tool that turns compiled macOS and iOS programs back into readable pseudo-code, as a queryable service. Once installed, the agent can look up functions and strings in Apple frameworks and app binaries, then combine that with local source code, the LLDB debugger, logs and small test cases to explain or diagnose a bug. It also records hard-won gotchas, such as which call syntax to use and how to avoid misreading licensing errors.

Great for

  • macOS or iOS developers investigating how an Apple framework behaves internally
  • Engineers debugging AppKit-level issues such as cursor or window behaviour that the public documentation does not explain
  • Users who already own Hopper Disassembler 6.0 or later and use the mcporter tool

Skip it if

  • People without Hopper Disassembler installed, since the skill is useless without it
  • Anyone wanting to reverse-engineer software they have no right to analyse, as the skill assumes legitimate research on owned or licensed binaries
  • Users who prefer not to run a local MCP server or let an agent drive desktop automation, because the instructions include AppleScript and daemon control

Try asking

  • “Find the procedure that handles addCursorRect in AppKit and summarise its control flow”
  • “Why does this macOS window lose cursor rects on the newest OS version? Compare the disassembly with a runtime probe”
  • “Open the AccessibilityKit framework in Hopper and list the segments and procedures related to focus handling”
  • “Search the AppKit binary for strings matching a given error message”
Step-by-step guide: how to use Hopper Binary DebuggerInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 2 original files, the MIT licence and an attribution note.

    hopper-debugger.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip hopper-debugger.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip hopper-debugger.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Always pass arguments with --args, never --params, or calls will silently fail with 'Document not found.'
  • Use --scope home when adding the mcporter config so you do not write config files into the project repo
  • Wrap Hopper calls in timeouts and avoid concurrent requests during imports to prevent hangs

What's inside

  • agents/openai.yaml
  • SKILL.md

Redistributed unmodified from steipete/agent-scripts under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.