steipete/hopper-debugger

Depuración Hopper: binarios macOS/iOS, símbolos ObjC/Swift, dyld, LLDB.

¿Qué es hopper-debugger?

Esta habilidad permite utilizar Hopper como un desensamblador consultable a través de `mcporter`, combinando los resultados con código fuente local, LLDB, registros y reproducciones enfocadas para depurar binarios de macOS e iOS. Soporta búsquedas de símbolos, procedimientos y cadenas en tiempo real, inspección de flujo de control (callers/callees), y extracción de pseudo-código. Es especialmente útil en tareas donde se necesita entender el comportamiento de frameworks de Apple como AppKit y SwiftUI, o cuando se investigan bugs de interacción de menús y barras de estado. Funciona con Claude Code, Cursor y Codex, y requiere tener Hopper Disassembler instalado y el servidor MCP de mcporter en ejecución. La habilidad enfatiza estrategias para evitar problemas de concurrencia y manejar fallos de conexión con Hopper, así como comparar desensamblado con estado en tiempo de ejecución mediante LLDB.

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

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Depurador Hopper

Objetivo: usar Hopper a través de mcporter como un desensamblador consultable, luego combinar el resultado con código fuente local, LLDB, registros y reproducciones enfocadas.

Inicio Rápido

Validar el servidor MCP:

MCPORTER_LIST_TIMEOUT=15000 timeout 20 mcporter list hopper --brief

Listar documentos abiertos en Hopper:

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

Si no hay ningún documento abierto, abre el binario/framework en Hopper primero:

open -a "Hopper Disassembler" /ruta/al/Binario

Es posible que Hopper muestre un diálogo de primera apertura/importación. Deja que el usuario haga clic en el botón de confirmación y luego reintenta la llamada MCP. Evita llamadas MCP paralelas a Hopper; el servidor puede cerrar el transporte o hacer que Hopper se bloquee mientras la importación aún se está estabilizando.

Frameworks de Apple

Prefiere los binarios de framework ya extraídos de dyld-cache cuando estén presentes:

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

Abre uno a la vez al depurar problemas en el límite de 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

Verificar acceso:

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

Los nombres de documentos pueden comenzar como Untitled; reintenta después de que Hopper termine de importar. Usa current_document, búsquedas de símbolos/cadenas y cambios en el título de la ventana para identificar AppKit vs SwiftUI.

Flujo de Trabajo de Consulta

  1. Comienza desde la ruta del código fuente local o el símbolo en tiempo de ejecución que intentas explicar.
  2. Busca nombres/procedimientos/cadenas:
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. Inspecciona un objetivo pequeño a la vez:
mcporter call hopper.procedure_info procedure='<símbolo>' --output json
mcporter call hopper.procedure_assembly procedure='<símbolo>' --output json
mcporter call hopper.procedure_pseudo_code procedure='<símbolo>' --output json
mcporter call hopper.procedure_callers procedure='<símbolo>' --output json
mcporter call hopper.procedure_callees procedure='<símbolo>' --output json
mcporter call hopper.xrefs address=0x12345678 --output json
  1. Resume el flujo de control relevante; no pegues descompilaciones grandes.
  2. Valida la hipótesis con LLDB/registros/reproducción antes de modificar el código de la aplicación.

Errores de Elemento de Estado / Clic en Menú

Búsquedas útiles en AppKit/SwiftUI:

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

Símbolos que vale la pena inspeccionar cuando los clics en la barra de menú no hacen nada:

  • -[NSStatusBarButtonCell trackMouse:inRect:ofView:untilMouseUp:]
  • -[NSStatusBarButtonCell _sendActionFrom:]
  • -[NSStatusItem popUpStatusBarMenu:]
  • -[NSApplication sendAction:to:from:]
  • Símbolos de estado/menú de SwiftUI que referencian NSStatusItem_Private_ForSwiftUI

Compara el desensamblado con el estado en tiempo de ejecución:

pgrep -af "App.app/Contents/MacOS/App"
lldb /ruta/al/Binario/debug

Para aplicaciones con firma reforzada, el adjuntar puede fallar sin get-task-allow; lanza el binario de depuración sin procesar bajo LLDB cuando sea necesario.

Manejo de Fallos

  • Envuelve las llamadas a Hopper con timeout; un modal/importación o documento cerrado puede dejar el transporte atascado.
  • No envíes solicitudes MCP concurrentes a Hopper durante la importación. Si una consulta es costosa, espera a que termine antes de iniciar otra.
  • Si las llamadas informan Connection closed, verifica si hay un modal en Hopper, luego reintenta después de la confirmación.
  • Si Hopper se bloquea, vuelve a abrir un solo documento, espera la importación/análisis, y vuelve a ejecutar list_documents antes de búsquedas más profundas.
  • Si mcporter está atascado, inspecciona los procesos antes de matar algo:
pgrep -af 'mcporter|HopperMCPServer|Hopper Disassembler'
  • Prefiere reiniciar el daemon de mcporter en lugar de matar procesos de forma amplia:
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 relacionados