steipete/native-app-performance

Performance native des applications : xctrace, Time Profiler, traces, hotspots.

Qu'est-ce que native-app-performance ?

Cette compétence permet d'analyser les performances des applications natives (macOS, iOS) en utilisant uniquement `xctrace` en ligne de commande, sans ouvrir l'application Instruments. Elle enregistre un profil Time Profiler, extrait les échantillons de temps dans un fichier XML, les symbolise avec les adresses de charge mémoire (`vmmap`) et propose les points chauds (hotspots) les plus fréquents. Cela est particulièrement utile pour les développeurs cherchant à identifier rapidement des goulots d'étranglement dans leur application sans interface graphique lourde. Compatible avec macOS et iOS, la compétence s'appuie sur les outils Xcode CLI (xctrace, atos) et des scripts Python fournis dans le dépôt.

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

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

Performance Application Native (CLI uniquement)

Objectif : enregistrer un profileur temporel via xctrace, extraire les échantillons, les symboliser et proposer les points chauds sans ouvrir Instruments.

Démarrage rapide (CLI)

  1. Enregistrer un profileur temporel (attachement) :
# Lancez l'application vous-même, puis attachez-vous
xcrun xctrace record --template 'Time Profiler' --time-limit 90s --output /tmp/App.trace --attach <pid>
  1. Enregistrer un profileur temporel (lancement) :
xcrun xctrace record --template 'Time Profiler' --time-limit 90s --output /tmp/App.trace --launch -- /path/App.app/Contents/MacOS/App
  1. Extraire les échantillons temporels :
scripts/extract_time_samples.py --trace /tmp/App.trace --output /tmp/time-sample.xml
  1. Obtenir l'adresse de chargement pour la symbolication :
# Pendant que l'application est en cours d'exécution
vmmap <pid> | rg -m1 "__TEXT" -n
  1. Symboliser + classer les points chauds :
scripts/top_hotspots.py --samples /tmp/time-sample.xml \
  --binary /path/App.app/Contents/MacOS/App \
  --load-address 0x100000000 --top 30

Notes de workflow

  • Vérifiez toujours que vous profilez le bon binaire (build local vs /Applications). Préférez un chemin direct du binaire pour --launch.
  • Assurez-vous de déclencher le chemin lent pendant la capture (ouverture/fermeture de menu, rafraîchissement, etc.).
  • Si les piles sont vides, capturez plus longtemps ou évitez les sections inactives.
  • xcrun xctrace help record et xcrun xctrace help export montrent les bons indicateurs.

Scripts inclus

  • scripts/record_time_profiler.sh : enregistrement par attachement ou lancement.
  • scripts/extract_time_samples.py : export du XML d'échantillons temporels depuis une trace.
  • scripts/top_hotspots.py : symbolication et classement des trames d'application principales.

Pièges

  • L'ASLR signifie que vous devez utiliser l'adresse de chargement __TEXT au moment de l'exécution provenant de vmmap.
  • Si vous utilisez une nouvelle build, mettez à jour le chemin --binary ; les symboles doivent correspondre à la trace.
  • Flux CLI uniquement : pas besoin d'ouvrir Instruments si les piles sont symbolisées via atos.

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/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

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.

Skills associés