CommunityRecherche & Datenanalysegithub.com

steipete/hopper-debugger

Hopper-Debugging: macOS/iOS-Binärdateien, ObjC/Swift-Symbole, dyld, LLDB.

Was ist hopper-debugger?

Dieser Skill verbindet Hopper Disassembler über mcporter mit der KI, um Binärdateien für macOS und iOS zu analysieren. Er ist besonders nützlich für das Debuggen von Frameworks wie AppKit und SwiftUI, bei denen Quellcode nicht direkt verfügbar ist. Der Skill unterstützt Workflows zur Suche nach Symbolen, Prozeduren und Zeichenfolgen sowie zur Inspektion von Assembly und Pseudocode – kombiniert mit LLDB und Laufzeit-Logs. Die Anwendung erfolgt schrittweise: Zuerst wird die Binärdatei in Hopper geöffnet, dann werden gezielte Abfragen durchgeführt, um Kontrollflüsse zu verstehen, und schließlich werden Hypothesen mit LLDB oder Reproduktionen validiert. Der Skill arbeitet auf der Kommandozeile (bash) und setzt mcporter, Hopper sowie optional LLDB voraus. Fehlerbehandlungen wie Timeouts, das Vermeiden paralleler Aufrufe und das Neustarten des mcporter-Daemons sind integriert, um Stabilität zu gewährleisten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/hopper-debugger

Installed? Explore more Recherche & Datenanalyse skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Hopper Debugger

Ziel: Hopper über mcporter als abfragbaren Disassembler nutzen, dann das Ergebnis mit lokalem Quellcode, LLDB, Logs und fokussierten Reproduktionen kombinieren.

Schnellstart

MCP-Server validieren:

MCPORTER_LIST_TIMEOUT=15000 timeout 20 mcporter list hopper --brief

Offene Hopper-Dokumente auflisten:

MCPORTER_CALL_TIMEOUT=20000 timeout 30 mcporter call hopper.list_documents --output json

Falls kein Dokument geöffnet ist, die Binärdatei/das Framework zuerst in Hopper öffnen:

open -a "Hopper Disassembler" /path/to/Binary

Hopper zeigt möglicherweise einen Ersteinrichtungs-/Importdialog. Lassen Sie den Benutzer auf den Bestätigungsbutton klicken und wiederholen Sie dann den MCP-Aufruf. Vermeiden Sie parallele Hopper-MCP-Aufrufe; der Server kann die Verbindung schließen oder Hopper zum Absturz bringen, während der Import noch läuft.

Apple Frameworks

Bevorzugen Sie bereits extrahierte dyld-Cache-Framework-Binärdateien, wenn vorhanden:

/tmp/dsc-appkit/System/Library/Frameworks/AppKit.framework/Versions/C/AppKit
/tmp/dsc-appkit/System/Library/Frameworks/SwiftUI.framework/Versions/A/SwiftUI

Öffnen Sie eine nach der anderen, wenn Sie Probleme an der SwiftUI/AppKit-Grenze debuggen:

open -a "Hopper Disassembler" /tmp/dsc-appkit/System/Library/Frameworks/AppKit.framework/Versions/C/AppKit
mcporter call hopper.list_documents --output json

open -a "Hopper Disassembler" /tmp/dsc-appkit/System/Library/Frameworks/SwiftUI.framework/Versions/A/SwiftUI
mcporter call hopper.list_documents --output json

Zugriff überprüfen:

mcporter call hopper.list_documents --output json
mcporter call hopper.current_document --output json
mcporter call hopper.search_strings pattern=SwiftUI --output json
mcporter call hopper.search_strings pattern=NSStatusItem --output json

Dokumentnamen können mit Untitled beginnen; wiederholen Sie den Vorgang, nachdem Hopper den Import abgeschlossen hat. Verwenden Sie current_document, Symbol-/Zeichenfolgensuchen und Änderungen des Fenstertitels, um AppKit von SwiftUI zu unterscheiden.

Abfrage-Workflow

  1. Beginnen Sie mit dem lokalen Quellpfad oder dem Laufzeitsymbol, das Sie erklären möchten.
  2. Suchen Sie nach Namen/Prozeduren/Zeichenfolgen:
mcporter call hopper.search_procedures pattern='NSStatusBar' --output json
mcporter call hopper.search_name pattern='NSStatusBarButtonCell' --output json
mcporter call hopper.search_strings pattern='NSStatusItem' --output json
  1. Untersuchen Sie ein kleines Ziel nach dem anderen:
mcporter call hopper.procedure_info procedure='<symbol>' --output json
mcporter call hopper.procedure_assembly procedure='<symbol>' --output json
mcporter call hopper.procedure_pseudo_code procedure='<symbol>' --output json
mcporter call hopper.procedure_callers procedure='<symbol>' --output json
mcporter call hopper.procedure_callees procedure='<symbol>' --output json
mcporter call hopper.xrefs address=0x12345678 --output json
  1. Fassen Sie den relevanten Kontrollfluss zusammen; fügen Sie keine großen Dekompilierungen ein.
  2. Validieren Sie die Hypothese mit LLDB/Logging/Reproduktion, bevor Sie App-Code ändern.

Status-Item / Menu-Klick-Fehler

Nützliche AppKit/SwiftUI-Suchen:

mcporter call hopper.search_strings pattern='NSStatusItem_Private_ForSwiftUI' --output json
mcporter call hopper.search_procedures pattern='popUpStatusBarMenu' --output json
mcporter call hopper.search_procedures pattern='trackMouse' --output json
mcporter call hopper.search_name pattern='NSStatusBarButtonCell' --output json
mcporter call hopper.search_name pattern='NSStatusItem' --output json

Symbole, die bei nicht funktionierenden Menüleistenklicks zu untersuchen sind:

  • -[NSStatusBarButtonCell trackMouse:inRect:ofView:untilMouseUp:]
  • -[NSStatusBarButtonCell _sendActionFrom:]
  • -[NSStatusItem popUpStatusBarMenu:]
  • -[NSApplication sendAction:to:from:]
  • SwiftUI-Status/Menü-Symbole, die auf NSStatusItem_Private_ForSwiftUI verweisen

Vergleichen Sie die Disassemblierung mit dem Laufzeitzustand:

pgrep -af "App.app/Contents/MacOS/App"
lldb /path/to/debug/Binary

Bei gehärteten signierten Apps kann das Anhängen ohne get-task-allow fehlschlagen; starten Sie das rohe Debug-Binary bei Bedarf unter LLDB.

Fehlerbehandlung

  • Umgeben Sie Hopper-Aufrufe mit timeout; ein modaler Dialog/Import oder ein geschlossenes Dokument kann den Transport hängen lassen.
  • Senden Sie keine gleichzeitigen Hopper-MCP-Anfragen während des Imports. Wenn eine Abfrage aufwändig ist, warten Sie, bis sie abgeschlossen ist, bevor Sie eine andere starten.
  • Wenn Aufrufe Connection closed melden, prüfen Sie auf einen Hopper-Dialog, und wiederholen Sie den Vorgang nach der Bestätigung.
  • Wenn Hopper abstürzt, öffnen Sie ein einzelnes Dokument erneut, warten Sie auf Import/Analyse, und führen Sie list_documents erneut aus, bevor Sie tiefer gehende Suchen durchführen.
  • Wenn mcporter festhängt, überprüfen Sie die Prozesse, bevor Sie etwas beenden:
pgrep -af 'mcporter|HopperMCPServer|Hopper Disassembler'
  • Bevorzugen Sie den Neustart des mcporter-Daemons gegenüber großflächigen Prozessbeendigungen:
mcporter daemon stop
mcporter daemon start

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

Verwandte Skills