| name | qa-__SLUG__ |
| description | Build, launch, and verify __APP_DISPLAY__ in the menu bar after a change. Confirms the running build is the one you just built. |
QA APP_DISPLAY
Use this to verify a change actually works in the real app.
Loop
make check — format + lint + test. Fix everything it reports before going further.
- Relaunch cleanly so you never validate a stale build:
pkill -x __APP__ || pkill -f __APP__.app || true
macos dev __SLUG__
- Confirm the build you're looking at is the one you just built:
pgrep -af "__APP__.app/Contents/MacOS/__APP__"
- Verify behavior:
- The status item appears in the menu bar; clicking it opens the menu.
- The menu rows reflect the current
AppStatus (cross-check with swift run __app__cli).
- Settings opens (menu → Settings, or ⌘,) and prefs persist across relaunch.
Rules
- Never trigger Keychain prompts. Credentials use file storage in DEBUG. Keep
KeychainPromptSafetyAuditTests green.
- If a test needs live network or a TTY, gate it behind an env var; don't make it run by default.
- Report what you observed (menu contents, log lines), not just "it works".