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

file-list

file-listTOOL
List a folder on the iPhone over USB (AFC): /DCIM, /Downloads, or an app's /Documents with --app
Each line: size, modified time (this Mac's time zone), path; folders end with /. 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: --recursive = recursive, --app = app
Examples (arguments): {"lease":"studio:42","path":"/"} {"lease":"studio:42","path":"/DCIM","recursive":true} {"app":"org.videolan.vlc-ios","lease":"studio:42","path":"/Documents"}
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, e.g. / or /DCIM
recursive?boolean
Also list everything in subfolders
Request example
{
  "method": "tools/call",
  "params": {
    "name": "file-list",
    "arguments": {
      "app": "string",
      "lease": "string",
      "mac": "string",
      "path": "string",
      "recursive": true
    }
  }
}