Community연구 & 데이터 분석github.com

Hopper Debugger

Hopper 디버깅: macOS/iOS 바이너리, ObjC/Swift 심볼, dyld, LLDB.

Hopper Debugger란 무엇인가요?

이 스킬은 Hopper Disassembler를 MCP 서버(mcporter)를 통해 질의 가능한 디스어셈블러로 활용하여, 로컬 소스, LLDB, 로그, 집중된 재현과 결합한 디버깅 워크플로우를 제공합니다. macOS/iOS 바이너리, Apple 프레임워크(AppKit, SwiftUI), dyld 캐시에서 추출된 프레임워크를 지원하며, ObjC와 Swift 심볼 이름, 문자열, 프로시저를 검색할 수 있습니다. 주요 기능으로는 현재 문서 조회, 심볼/문자열 검색, 프로시저 정보/어셈블리/의사 코드/호출자/피호출자 확인, 주소 기반 교차 참조(XREF) 분석이 있으며, 검색 결과를 바탕으로 제어 흐름을 요약하고 LLDB/로깅을 통해 가설을 검증합니다. 이 스킬은 Claude Code, Cursor 등의 에이전트와 함께 사용되며, Hopper MCP 서버의 안정적인 호출을 위해 타임아웃 설정, 단일 호출 직렬화, 임포트 중 동시 요청 회피 등 실패 처리 가이드를 포함합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/hopper-debugger

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Hopper Debugger은(는) 무엇을 하나요?

목표: mcporter를 통해 Hopper를 질의 가능한 디스어셈블러로 사용하고, 그 결과를 로컬 소스, LLDB, 로그, 집중된 재현과 결합합니다.

빠른 시작

MCP 서버 검증:

MCPORTER_LIST_TIMEOUT=15000 timeout 20 mcporter list hopper --brief

열려 있는 Hopper 문서 나열:

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

문서가 열려 있지 않으면 먼저 Hopper에서 바이너리/프레임워크를 엽니다:

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

Hopper가 첫 열기/가져오기 대화상자를 표시할 수 있습니다. 사용자가 확인 버튼을 클릭하게 한 후 MCP 호출을 재시도하세요. Hopper MCP 호출을 병렬로 실행하지 마십시오; 임포트가 안정화되는 동안 서버가 전송을 닫거나 Hopper가 충돌할 수 있습니다.

Apple 프레임워크

가능하면 이미 추출된 dyld-cache 프레임워크 바이너리를 선호합니다:

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

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

접근 확인:

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

문서 이름은 Untitled로 시작할 수 있습니다; Hopper가 가져오기를 완료한 후 재시도하세요. current_document, 심볼/문자열 검색, 창 제목 변경을 사용하여 AppKit과 SwiftUI를 식별합니다.

질의 워크플로우

  1. 설명하려는 로컬 소스 경로 또는 런타임 심볼에서 시작합니다.
  2. 이름/프로시저/문자열을 검색합니다:
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. 한 번에 하나의 작은 대상을 검사합니다:
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. 관련 제어 흐름을 요약합니다; 큰 역컴파일 결과를 붙여넣지 마십시오.
  2. 앱 코드를 편집하기 전에 LLDB/로깅/재현을 통해 가설을 검증합니다.

상태 항목 / 메뉴 클릭 버그

유용한 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

메뉴 막대 클릭이 작동하지 않을 때 검사할 가치가 있는 심볼:

  • -[NSStatusBarButtonCell trackMouse:inRect:ofView:untilMouseUp:]
  • -[NSStatusBarButtonCell _sendActionFrom:]
  • -[NSStatusItem popUpStatusBarMenu:]
  • -[NSApplication sendAction:to:from:]
  • NSStatusItem_Private_ForSwiftUI를 참조하는 SwiftUI 상태/메뉴 심볼

디스어셈블리를 런타임 상태와 비교:

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

강화된 서명 앱의 경우 get-task-allow가 없으면 연결이 실패할 수 있습니다; 필요시 LLDB에서 원시 디버그 바이너리를 실행합니다.

실패 처리

  • Hopper 호출에 timeout을 감싸십시오; 모달/가져오기 또는 닫힌 문서로 인해 전송이 멈출 수 있습니다.
  • 가져오기 중에 동시 Hopper MCP 요청을 보내지 마십시오. 질의가 무거우면 다른 질의를 시작하기 전에 완료될 때까지 기다리십시오.
  • 호출이 Connection closed를 보고하면 Hopper 모달을 확인한 후 확인 후 재시도하십시오.
  • Hopper가 충돌하면 단일 문서를 다시 열고, 가져오기/분석이 완료될 때까지 기다린 후, 더 깊은 검색 전에 list_documents를 다시 실행하십시오.
  • mcporter가 멈춘 경우, 아무것도 종료하기 전에 프로세스를 검사하십시오:
pgrep -af 'mcporter|HopperMCPServer|Hopper Disassembler'
  • 광범위한 프로세스 종료보다 mcporter 데몬을 재시작하는 것을 선호합니다:
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.

관련 스킬