Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

file-pull

file-pullTOOL
Copy a file or folder from the iPhone to this Mac over USB
A file goes to [local path] (default: its name in this folder). A folder is unpacked inside [local path] (default: this folder), keeping its name. For the newest photos use photo pull; it finds them for you. MCP takes only the iPhone path: it returns original bytes as an embedded resource blob (folders as .zip), up to 16 MiB. There is no Mac destination argument. Files go over USB (AFC), no Developer Mode. Paths start with /. The default root is the iPhone's media folder (/var/mobile/Media): /DCIM Camera Roll: photos, videos, screenshots (IMG_0001.PNG ...). Use the photo commands /Downloads iOS download databases, not the Files app /Books, /PublicStaging, /iTunes_Control, /PhotoData (mostly not readable)
  • The Files app ("On My iPhone") and app data are not in this folder. --app <bundle id> reaches an app's Documents (/Documents/...), only for apps with [file sharing] in app list.
  • A file copied to /DCIM does not appear in Photos. To get a photo or video into Photos (for TikTok, Instagram): ghosthand upload <file>, open the link in Safari, tap Save, then Save Video or Save Image (see upload --help). Offline: push it to VLC's Documents (--app org.videolan.vlc-ios), then Files > Share > Save Video. Steps: https://ghosthand.dev/docs/send-media
  • Works while the iPhone is locked, after its first unlock since boot.
CLI flags in this text are arguments: --app = app
Parameters
app?string
Bundle id of an app with file sharing (see app-list): the path is then in its container, e.g. /Documents/a.pdf
lease *string
Lease id exactly as acquire printed it, e.g. "studio:42"
mac?string
Mac slug from list, e.g. "studio". Needed when several Macs are online
path *string
Absolute iPhone path of a file or folder
Request example
{
  "method": "tools/call",
  "params": {
    "name": "file-pull",
    "arguments": {
      "app": "string",
      "lease": "string",
      "mac": "string",
      "path": "string"
    }
  }
}