Przejdź do treści
Biblioteka skilli
Produktywność osobista · Integracja z narzędziem

ghosthand

/ghosthand

Steruje podłączonym do Maca iPhone'em: zrzuty ekranu, OCR, dotyk, przewijanie, wpisywanie, pliki i zdjęcia przez USB i Bluetooth.

Repozytorium
ghosthand ↗
Licencja
MIT
Ostatnia zmiana repozytorium
10.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 10.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

Phone tips
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

  1. Phone tips
  2. CLI rules
Sekcje z nagłówków SKILL.md, w oryginale · 36 linii, 601 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.