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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.8 KB |
SKILL.md
View on GitHub---
name: run-app
description: Build, 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.
1. `bun devices list`. Copy one value of column `OPTION`: `--platform=<ios|android>` for simulator or emulator, `--target=<target>` for a phone. Use it as `<device>` below.
Phone: needs `SIMLOCK_URL` and `SIMLOCK_TOKEN`. The first phone command leases it from simlock; other agents wait until `bun app close`.
2. `bun app install <device>`
3. `bun app seed <device> --fixture=<id>` (ids: `bun app seed --help`)
4. `bun app open <device>`
5. Use the app: `bun app drive <device> -- <agent-device args>`. Commands: `bunx agent-device help workflow`. Never call `bunx agent-device` directly: it picks its own session and cannot reach a simlock phone.
6. `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](../../../docs/development.md#phones).
# 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`, or `e2e run`: check `xcrun simctl list devices booted` (iOS) or `adb 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>]`.
1. Start the command with `run_in_background`.
2. Wait for the exit notification. Read `PIXY_RESULT` for the result.
3. To watch progress, Monitor `tail -n 0 -F <Log path> | grep -E --line-buffered 'Step |PIXY_RESULT|error:|BUILD FAILED'`. Take the path from the `Log:` line of this run only.
- Never poll with `sleep N; tail`. Never reuse old `/tmp` or 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.
1. `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.
2. Edit code. The app reloads. Rerun step 1 to reload by hand.
3. Drive the app: `bun app drive --platform=<ios|android> -- <agent-device args>`. App ID `com.devmood.pixymoodtracker.dev`.
4. `bun app close --platform=<ios|android>` stops Metro and the device.
Rules:
- Builds live in `~/.cache/pixy-mood-tracker/build-cache`. `bun builds list` shows them. Never search `ios/build` or `~/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`, `:t` after `$VAR` as 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 |