ghosthand
/ghosthand
Steruje podłączonym do Maca iPhone'em: zrzuty ekranu, OCR, dotyk, przewijanie, wpisywanie, pliki i zdjęcia przez USB i Bluetooth.
- Autor
- ghosthand-dev ↗
- Repozytorium
- ghosthand ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 10.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 1
Brak sygnałów. Repozytorium zmienione 10.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
Steruje podłączonym do Maca iPhone'em: zrzuty ekranu, OCR, dotyk, przewijanie, wpisywanie, pliki i zdjęcia przez USB i Bluetooth.
Wyzwalacze z opisu
Oryginalny opis (EN)
Control a real iPhone connected to this Mac with the ghosthand CLI: screenshots and on-device OCR over USB, taps, swipes, scroll, keys and typing over Bluetooth, and files, photos, apps, battery and logs over USB. Use it to open apps, read messages, reply, fill forms, get photos or files off the iPhone, or do any task on the user's iPhone. ALWAYS load this skill when the user mentions ghosthand, their iPhone or phone, or asks to do something on a phone app (Messages, WhatsApp, Instagram, TikTok, Settings, App Store). # The "Phone tips" section is also in the system prompt of the ghosthand.dev
Jak działa
- Phone tips
- CLI rules
Podgląd SKILL.md
--- name: ghosthand description: > Control a real iPhone connected to this Mac with the ghosthand CLI: screenshots and on-device OCR over USB, taps, swipes, scroll, keys and typing over Bluetooth, and files, photos, apps, battery and logs over USB. Use it to open apps, read messages, reply, fill forms, get photos or files off the iPhone, or do any task on the user's iPhone. ALWAYS load this skill when the user mentions ghosthand, their iPhone or phone, or asks to do something on a phone app (Messages, WhatsApp, Instagram, TikTok, Settings, App Store). # The "Phone tips" section is also in the system prompt of the ghosthand.dev task agent # (website/src/task-agent.ts imports it). Keep it free of CLI flags and CLI-only commands. --- # ghosthand Before the first ghosthand command in a session, run: ```bash ghosthand --help # NEVER pipe to head/tail, read the full output ``` The help output is the full agent manual: leases, coordinates, the screenshot feedback loop, and what to do on each error. Read `ghosthand <command> --help` before using a command for the first time. If `ghosthand` is not found, use `npx -y ghosthand@latest` instead. Without Node.js (installed from the download page), use `~/Applications/Ghosthand.app/Contents/MacOS/ghosthand`. Pro subscribers also get the task skills `ghosthand-accounts` (Google, Apple, App Store and social account signup) and `tiktok-warmup` (watch and like TikTok videos for a niche) in the private daemon repo: https://ghosthand.dev/docs/pricing ## Phone tips - **Prefer full app access.** When the app being used requests permission, grant the broadest available access unless the user explicitly restricts it: camera, microphone, Full Photos Access (not limited selection), contacts, notifications, location, and tracking. Complete related in-app access prompts too, so controls work immediately and repeated dialogs are reduced. Do not ask again for routine permission choices. - Permission approval does not authorize purchases, unrelated account linking, publishing, follows, messages, or disabling security. - Open apps with `key` cmd+space, `type` the app name, `key` enter (works from any app). Faster than swiping Home Screen pages. If the app did not open, tap its icon in the results. - A button that ignores a tap: read the screen, then press it once more. A just-opened alert can ignore the first press. - Never repeat an input after a timeout or an error that says it was sent. Look at the screen first. ## CLI rules - Always `acquire` a lease with `--reason "<task>"` first, pass `-l <id>` to every command, and `release` it when done. - Never retry a passcode or repeat input after a verification timeout. Take a screenshot first. - **Never `sleep` to wait for the phone.** Add `--screenshot` and `--screentext` to the action itself: they wait until the screen is still, then return it. To wait for a page that loads, pass `--wait-text "<expected text>"`. A `sleep` before a screenshot only adds seconds to every step. - Screen dimmed but no dialog in the screenshot: run `screenshot -l <id> --native -o real.png` (a real iOS screenshot that shows hidden system dialogs, deleted from Photos after reading) and tap at the coordinates in it. It is slow (2-7 s); use it only for this, never as the normal screenshot. A button that ignores `tap` may also take `hold x y --duration 400`. - Long press (context menus): `hold x y`. Move an item after a long press: `hold-drag` (read its `--help`). - Photos, files and apps go over USB without the screen: `photo pull`, `file pull`, `file push`, `app list`, `info`, `logs`. Read each `--help` first. - If a dialog does not respond or is invisible to capture, try `lock -l <id>`, then `unlock -l <id> --stdin --screenshot s.png --screentext` once to dismiss it, not accept an option. First obtain a user-confirmed passcode from the secret provider and pipe it to unlock. Without one, ask the user before locking. This may not dismiss every dialog; check the result and never retry a failed passcode. - Leave the iPhone unlocked when done. - Ghosthand's Mac setup window is user-only. - `login-required` or `subscription-required` from acquire: follow the error text. Open `ghosthand setup` once and tell the user to complete setup in the small Ghosthand window, or show the subscribe link. All Ghosthand window actions are user-only; never interact with the window or complete setup for the user. Never run `ghosthand login` yourself and never retry in a loop.
Wersje
W bazie nie ma innych skilli o nazwie ghosthand.
Migawka bazy z 13.11.2026 · wersja paczki 9d61e2491171 (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
- 95phoneuse
Ogląda i steruje iPhonem z komputera przez CLI phoneuse, z lustrzanym odbiciem ekranu i klawiaturą Bluetooth. - 100esp32-streamshot
Steruje iPhonem przez udostępnianie ekranu StreamShot i klawiaturę lub mysz Bluetooth z ESP32-S3, wraz z diagnozą połączenia. - 96phone-harness
Steruje fizycznym telefonem z Androidem podłączonym przez USB i ADB, np. dotyka ekranu, pisze i robi zrzuty. - 95agent-bluetooth
Wykonuje połączenia i SMS-y oraz sprawdza kontakty na telefonie przez demona agent-bluetooth. - 100iphone-mirroring
Steruje aplikacją iPhone Mirroring na Macu z poziomu agenta: robi zrzuty ekranu, dotyka, przewija i sprawdza każdy krok na świeżym obrazie. - 95phone-control
Czyta i steruje ekranem telefonu z Androidem: drzewo interfejsu, dotknięcia, przewijanie, wpisywanie i zrzuty ekranu.