run-app
/run-app
Buduje, uruchamia i fotografuje aplikację macOS Private Meeting Assistant, by sprawdzić zmianę interfejsu w działaniu.
- Autor
- ruyd ↗
- Repozytorium
- private-meeting-assistant ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 09.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 09.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Buduje, uruchamia i fotografuje aplikację macOS Private Meeting Assistant, by sprawdzić zmianę interfejsu w działaniu.
Oryginalny opis (EN)
Build, launch, drive and screenshot the Private Meeting Assistant macOS app (Debug) to see a UI change working. Use when asked to run, start or screenshot the app, or to check a change in the real app rather than in tests.
Jak działa
- Claude desktop Run button
- Notes
Podgląd SKILL.md
---
name: run-app
description: Build, launch, drive and screenshot the Private Meeting Assistant macOS app (Debug) to see a UI change working. Use when asked to run, start or screenshot the app, or to check a change in the real app rather than in tests.
---
# Run the macOS app
Everything goes through `mac/scripts/run-app.sh` (run from the repo root). It finds Xcode even when
`xcode-select` points at the Command Line Tools, so don't set `DEVELOPER_DIR` yourself.
```bash
mac/scripts/run-app.sh build # xcodegen + Debug build; prints errors and BUILD SUCCEEDED/FAILED
mac/scripts/run-app.sh launch # quits any running copy, launches, prints windows
mac/scripts/run-app.sh shot <scratchpad>/main.png # screenshot of the main window
mac/scripts/run-app.sh settings Accounts # open Settings on a tab: Transcription, Summaries, Accounts, Storage, Permissions, About
mac/scripts/run-app.sh shot <scratchpad>/settings.png Accounts # screenshot a window by title substring
mac/scripts/run-app.sh windows # "<id> <title>" per window
mac/scripts/run-app.sh quit
```
Then **Read the PNG and look at it**: a blank or missing window means the launch failed.
## Claude desktop Run button
`.claude/launch.json` runs `mac/scripts/preview-server.py` on port 8765: it builds and launches the
app with `-previewSnapshots mac/build/preview`, and serves a page that mirrors the app's windows
every second. Stopping the preview quits the app. The Debug app saves its own windows
(`Debug/WindowSnapshots.swift`, ScreenCaptureKit with the app's own Screen Recording permission), so
neither Claude nor Python needs that permission. Without it, the app draws the windows itself and
translucent areas such as the sidebar come out blank.
## Notes
- Save screenshots in the session's scratchpad directory, not the repo.
- The app shows the user's real meetings, so screenshots include them: keep them in the scratchpad
and don't publish them. Extra args go to the app, e.g. the Debug self-tests `--capture-test`,
`--transcribe-test` (see `mac/PrivateMeetingAssistant/Debug/CaptureSelfTest.swift`).
- The main window's title is the page shown ("New Recording", or a meeting's title); Settings' title
is the selected tab.
- Clicking elsewhere in the UI: use AppleScript through System Events, as `settings` does, e.g.
`osascript -e 'tell application "System Events" to tell (first process whose name is "Private Meeting Assistant") to click button "Refresh" of window 1'`.
For anything deeper, use computer use.
- Screenshots need Screen Recording permission, and `settings`/clicks need Accessibility permission,
for the app running the commands. If `shot` fails with an empty capture or `osascript` errors with
"not allowed assistive access", ask the user to grant it in System Settings › Privacy & Security.
- The app is signed with the Developer ID set in `mac/project.yml`; the build fails without that
certificate in the keychain.
- Starting a real recording needs microphone and system-audio permission and a downloaded speech
model; don't start one unless the task needs it.
- Unit tests are separate:
`DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer xcodebuild -project mac/PrivateMeetingAssistant.xcodeproj -scheme PrivateMeetingAssistant -destination 'platform=macOS' test`
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · ruyd/private-meeting-assistant | 100 | MIT |
| tonk-labs/tonk | 100 | MIT |
| ChrisTowles/towles-tool | 100 | MIT |
| Esposter/Esposter | 90 | Apache-2.0 |
| yuri-xyz/skills | 86 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki 252313283aa6 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 98run-wenlan-app
Buduje i uruchamia aplikację Tauri wenlan w trybie dev na macOS lub Windows, robi zrzuty ekranu i sprawdza interfejs. - 100run-simulator
Buduje, instaluje, uruchamia i fotografuje aplikację iOS w Simulatorze, aby wizualnie zweryfikować zmianę, zamiast poprzestawać na samej kompilacji. - 100run
Uruchamia aplikację projektu i sprawdza zmianę w działającej aplikacji, na przykład przez zrzut ekranu, uzupełniając wyniki testów. - 100run
Uruchamia aplikację projektu i pokazuje działanie zmiany przez zrzut ekranu oraz podgląd w przeglądarce. - 100build-and-verify
Buduje aplikację SwiftUI na macOS, instaluje ją i sprawdza zrzuty wszystkich stron w obu motywach po zmianie UI. - 100build-and-verify
Buduje aplikację SwiftUI na macOS z wiersza poleceń i sprawdza zrzuty okien w jasnym i ciemnym motywie.