ghost/files

Android Files (DocumentsUI): list a folder, search files by name, create a folder in internal storage. No account needed.

Runs Score 20/100 Official hard skill python filesstorage

3actions not benchmarked yet

No clean demo yet. Recordings will start on HOME and show the app launching.

files

Demo shows: create_folder (path=Documents, name=Receipts0323)

Ghost in the Droid seed skill for the Android Files app (com.google.android.documentsui). Works without an account.

ActionWhat it doesParams
list_folderItems in an internal-storage folderpath (default Download)
search_filesFiles whose name matches a queryquery
create_folderCreate an empty folder inside a parent folderpath (default Documents), name

Install

pip install "ghost-in-the-droid>=1.6.0"   # 1.6.0 is not on PyPI yet: until it ships, git clone the repo and `pip install -e .`
ghost skill install ghost/files

Use

ghost skill run ghost/files list_folder --param path=Download --device emulator-5554
ghost skill run ghost/files search_files --param query=report --device emulator-5554
ghost skill run ghost/files create_folder --param path=Documents --param name=Receipts --device emulator-5554

From any MCP agent:

run_skill(name="ghost/files", action="list_folder", params={"path": "Download"})
# {"items": [{"name": "notes.txt", "size": "19 B", "date": "8:17 PM", "is_folder": false}], "count": 1}

Tested on

Android 14 emulator (google_apis x86_64, 1080x2400, 420 dpi), DocumentsUI 14, en-US. Signed self-runs live in runs/.

Notes

Nothing is deleted, moved or uploaded. License: MIT.

Known failure modes and versions tested

Versions tested

App versionAndroidDeviceSkill versionSigned self-runs (pass/total)Dates
14-1054144314Google/sdk_gphone64_x86_64 (emulator, 1080x2400, 420 dpi, en-US)1.0.09/92026-10-05

Untested so far: physical devices, other OEM skins, other screen sizes, other locales.

Recorded failures

None in the signed self-runs.

Popups and first-run screens handled

  • None app-specific; Android permission dialogs go through the engine's OS popup layer.

Other known failure modes

  • Read-only roots (Recent, Images) offer no New folder; create_folder fails with a clear error.
  • Names with characters the IME cannot type via input text (emoji) need a clipboard paste.

Try a sample prompt or run an action by name. Replace any parameters in braces with your own values.

list_folder

no demo yet

Try asking

  • What's in my Download folder?
  • list files in Documents
  • show me what I downloaded
  • what photos are in DCIM/Camera
ghost skill run ghost/files list_folder

search_files

no demo yet

Try asking

  • Find the file called notes
  • search my files for report
  • is there a pdf named invoice on the phone
  • look for todo.txt
ghost skill run ghost/files search_files

create_folder

no demo yet

Try asking

  • Make a folder called Receipts in Documents
  • create a Taxes folder in Download
  • new folder Projects under Documents
  • add a folder named Scans
ghost skill run ghost/files create_folder