steipete/hopper-debugger

Débogage Hopper : binaires macOS/iOS, symboles ObjC/Swift, dyld, LLDB.

Qu'est-ce que hopper-debugger ?

Ce skill permet d'utiliser Hopper Disassembler comme un désassembleur interactif via `mcporter`, en combinaison avec le code source local, LLDB, les logs et des reproductions ciblées. Il facilite l'analyse des binaires d'Apple (comme AppKit et SwiftUI), la recherche de symboles et de chaînes, l'inspection de procédures (assemblage, pseudo-code, appelants/appelés) et la validation des hypothèses via LLDB. Idéal pour les développeurs qui déboguent des bugs complexes sur macOS ou iOS, notamment les problèmes de menu bar, de clics ou de comportements inattendus dans les frameworks système. Le skill fonctionne avec l'outil `mcporter` (MCP) et nécessite que Hopper soit ouvert avec le binaire cible importé. Il inclut des conseils pour gérer les échecs (timeouts, plantages, binaires signés) et éviter les appels simultanés qui pourraient déstabiliser Hopper.

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

Installed? Explore more Recherche et analyse de données skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Débogueur Hopper

Objectif : utiliser Hopper via mcporter comme désassembleur interrogeable, puis combiner le résultat avec le code source local, LLDB, les logs et des reproductions ciblées.

Démarrage rapide

Valider le serveur MCP :

MCPORTER_LIST_TIMEOUT=15000 timeout 20 mcporter list hopper --brief

Lister les documents Hopper ouverts :

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

Si aucun document n'est ouvert, ouvrir le binaire/framework dans Hopper d'abord :

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

Hopper peut afficher une boîte de dialogue de première ouverture/importation. Laissez l'utilisateur cliquer sur le bouton de confirmation, puis réessayez l'appel MCP. Évitez les appels MCP Hopper parallèles ; le serveur peut fermer le transport ou faire planter Hopper pendant que l'importation est encore en cours.

Frameworks Apple

Privilégiez les binaires de framework déjà extraits du cache dyld lorsqu'ils sont présents :

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

Ouvrez-les un par un lors du débogage de problèmes à la frontière SwiftUI/AppKit :

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

Vérifier l'accès :

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

Les noms de document peuvent commencer par Untitled ; réessayez après la fin de l'importation par Hopper. Utilisez current_document, les recherches de symboles/chaînes et les changements de titre de fenêtre pour identifier AppKit par rapport à SwiftUI.

Flux de travail d'interrogation

  1. Commencez par le chemin source local ou le symbole d'exécution que vous essayez d'expliquer.
  2. Recherchez des noms/procédures/chaînes :
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. Inspectez une petite cible à la fois :
mcporter call hopper.procedure_info procedure='<symbole>' --output json
mcporter call hopper.procedure_assembly procedure='<symbole>' --output json
mcporter call hopper.procedure_pseudo_code procedure='<symbole>' --output json
mcporter call hopper.procedure_callers procedure='<symbole>' --output json
mcporter call hopper.procedure_callees procedure='<symbole>' --output json
mcporter call hopper.xrefs address=0x12345678 --output json
  1. Résumez le flux de contrôle pertinent ; ne collez pas de grandes décompilations.
  2. Validez l'hypothèse avec LLDB/la journalisation/la reproduction avant de modifier le code de l'application.

Bugs d'élément de statut / clic de menu

Recherches AppKit/SwiftUI utiles :

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

Symboles intéressants à inspecter lorsque les clics de la barre de menu ne font rien :

  • -[NSStatusBarButtonCell trackMouse:inRect:ofView:untilMouseUp:]
  • -[NSStatusBarButtonCell _sendActionFrom:]
  • -[NSStatusItem popUpStatusBarMenu:]
  • -[NSApplication sendAction:to:from:]
  • Symboles SwiftUI statut/menu qui référencent NSStatusItem_Private_ForSwiftUI

Comparez le désassemblage avec l'état d'exécution :

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

Pour les applications signées avec renforcement, l'attachement peut échouer sans get-task-allow ; lancez le binaire de débogage brut sous LLDB si nécessaire.

Gestion des échecs

  • Encapsulez les appels Hopper avec timeout ; une fenêtre modale, une importation ou un document fermé peut bloquer le transport.
  • N'envoyez pas de requêtes MCP Hopper concurrentes pendant l'importation. Si une requête est coûteuse, attendez qu'elle se termine avant d'en lancer une autre.
  • Si les appels signalent Connection closed, vérifiez s'il y a une fenêtre modale Hopper, puis réessayez après confirmation.
  • Si Hopper plante, rouvrez un seul document, attendez l'importation/analyse, et relancez list_documents avant des recherches plus approfondies.
  • Si mcporter est bloqué, inspectez les processus avant de tuer quoi que ce soit :
pgrep -af 'mcporter|HopperMCPServer|Hopper Disassembler'
  • Préférez redémarrer le démon mcporter plutôt que de tuer des processus en masse :
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.

Skills associés