list_folder
no demo yetTry 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 Android Files (DocumentsUI): list a folder, search files by name, create a folder in internal storage. No account needed.
3actions not benchmarked yet
No clean demo yet. Recordings will start on HOME and show the app launching.
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.
| Action | What it does | Params |
|---|---|---|
list_folder | Items in an internal-storage folder | path (default Download) |
search_files | Files whose name matches a query | query |
create_folder | Create an empty folder inside a parent folder | path (default Documents), name |
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
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}
Android 14 emulator (google_apis x86_64, 1080x2400, 420 dpi), DocumentsUI 14, en-US. Signed self-runs live in runs/.
Nothing is deleted, moved or uploaded. License: MIT.
| App version | Android | Device | Skill version | Signed self-runs (pass/total) | Dates |
|---|---|---|---|---|---|
| 14-10541443 | 14 | Google/sdk_gphone64_x86_64 (emulator, 1080x2400, 420 dpi, en-US) | 1.0.0 | 9/9 | 2026-10-05 |
Untested so far: physical devices, other OEM skins, other screen sizes, other locales.
None in the signed self-runs.
New folder; create_folder fails with a clear error.input text (emoji) need a clipboard paste.SOFT.md is the narrative an agent reads when the exact steps no longer match your app version and it has to adapt the skill.
What each action means, which UI landmarks it relies on, and how success is recognised, so an agent can adapt it to another file manager or version.
Package: com.google.android.documentsui (Files / DocumentsUI)
Verified: 2026-10-05 on a headless emulator pool, Android 14 google_apis x86_64, 1080x2400 @ 420 dpi, DocumentsUI 14, en-US, no Google account.
Skill class: HARD. No login, no checkpoints.
android.intent.action.VIEW, MIME vnd.android.document/directory, data content://com.android.externalstorage.documents/document/primary%3A<url-encoded path>.id/header_title reads Files in <folder>; it is the proof that the requested folder (not a fallback view) is showing. An unknown path opens another view, and the actions then fail.id/item_root cards (grid) or rows (list). Inside, framework ids: android:id/title (name), android:id/details (size; absent for folders), android:id/date.id/option_menu_search (Search), More options overflow with New folder, Sort by..., Select all.list_folder(path)Open the folder by URI, read items while scrolling. Returns items: [{name, size, date, is_folder}].
search_files(query)From a folder, tap Search, type the query, press Enter. DocumentsUI searches all of internal storage by name. Returns matching items; success requires every returned name to contain the query.
create_folder(path, name)Open the parent folder, More options > New folder, tap the name field (android:id/text1), type, tap OK (android:id/button1; the dialog moves up when the keyboard opens, so it is located again after typing). Success: a folder item named name in the parent.
Files were pushed with adb shell into /sdcard/Download and /sdcard/Documents (notes.txt, report-2026.pdf, todo.txt).
New folder; create_folder fails with a clear error.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_folderTry asking
ghost skill run ghost/files list_folder search_filesTry asking
ghost skill run ghost/files search_files create_folderTry asking
ghost skill run ghost/files create_folder Each release is an immutable git tag. The tree hash pins the exact skill directory the installer verifies.
| Version | Released | App versions | Tree | Size | Provenance |
|---|---|---|---|---|---|
1.0.0latest | never | >=14 | pending | 16.4 KB | untagged |