mrzmyr/pixy-mood-tracker-app / .agents/skills/run-app
run-app
VerifiedBuild, install, and run the app on a device. Use when asked to run the app, run it with Metro for hot reload, install a build on a phone, simulator, or emulator, or time a native build.
Steps
Run in order. Relay each Step N line. Do not pick variants; the CLI owns them.
bun devices list. Copy one value of columnOPTION:--platform=<ios|android>for simulator or emulator,--target=<target>for a phone. Use it as<device>below. Phone: needsSIMLOCK_URLandSIMLOCK_TOKEN. The first phone command leases it from simlock; other agents wait untilbun app close.bun app install <device>bun app seed <device> --fixture=<id>(ids:bun app seed --help)bun app open <device>- Use the app:
bun app drive <device> -- <agent-device args>. Commands:bunx agent-device help workflow. Never callbunx agent-devicedirectly: it picks its own session and cannot reach a simlock phone. bun app close <device>. Phone: also ends the simlock lease.
e2e: bun e2e run --platform=<ios|android> [--paths=<path,...>]. Phones cannot run flows yet.
Help and errors: bun <noun> <command> --help. Limits on phones: development.md.
Device limit
At most 1 iOS simulator and 1 Android emulator run on a machine at a time. More runs the host out of memory.
- Before
app install,app dev, ore2e run: checkxcrun simctl list devices booted(iOS) oradb devices(Android). If another checkout's device runs, wait until it closes or ask the user. Never boot a second one. - Always finish with
bun app close <device>.
Waiting
app build, app install, app dev, and e2e run take minutes. First stderr line: Log: <path>, new file per run. Last stdout line: PIXY_RESULT status=<ok|error> command=<name> [code=<status>] [path=<artifact>].
- Start the command with
run_in_background. - Wait for the exit notification. Read
PIXY_RESULTfor the result. - To watch progress, Monitor
tail -n 0 -F <Log path> | grep -E --line-buffered 'Step |PIXY_RESULT|error:|BUILD FAILED'. Take the path from theLog:line of this run only.
- Never poll with
sleep N; tail. Never reuse old/tmpor log files. - Never switch verification surface (web, Playwright, other device) while you wait, unless the user asks.
Development with Metro (hot reload)
Use when the user edits code and wants to see changes without a native build.
bun app dev --platform=<ios|android>. Installs the cached dev client, starts this checkout's Metro, opens the app, prints a screenshot path. Data and flags in one go:bun app dev --platform=ios --fixture=year --flag=people=on,photos=off. Dev menu stays hidden.- Edit code. The app reloads. Rerun step 1 to reload by hand.
- Drive the app:
bun app drive --platform=<ios|android> -- <agent-device args>. App IDcom.devmood.pixymoodtracker.dev. bun app close --platform=<ios|android>stops Metro and the device.
Rules:
- Builds live in
~/.cache/pixy-mood-tracker/build-cache.bun builds listshows them. Never searchios/buildor~/Library/Developer/Xcode/DerivedData, never conclude "no dev build" from them. - Never create simulators by hand. The CLI owns one simulator per checkout.
- Dev client is shared across worktrees with the same native dependencies. A cache miss means native dependencies changed. Compile then, not before.
- Phones:
bun ios --device <udid>.
Shell (zsh)
- Never put several flags in one variable (
$FLAGS). zsh does not split words, so the command gets one argument. Use an array:flags=(--platform=ios); bun app drive "${flags[@]}" -- snapshot - Write
${VAR}:path, not$VAR:path. zsh reads:r,:h,:tafter$VARas modifiers. - Quote globs in arguments (
--include='*.ts'). zsh fails the command on an unmatched glob:no matches found.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |