search_apps
Play demoTry asking
- Find a markdown editor on F-Droid
- search f-droid for a podcast app
- is there an open source password manager on fdroid
- look up weather apps in F-Droid
ghost skill run ghost/fdroid search_apps F-Droid: search the FOSS catalogue, read an app's page, browse a category, list installed apps. Read-only; never installs.
Task check: passed without the skill, passed with it.
One recorded run each way on search_apps, claude-haiku-5-5, same phone and same prompt. Watch it in the Before / after tab.
29× fewer tokens, 1.5× slower with the skill. Task check: passed without the skill, passed with it.
| Run | Time | Tokens | Tool calls | Result |
|---|---|---|---|---|
| No skill: agent drives by hand | 67.2 s | 615,049 | 26 | passed |
With skill: find_skill, run_skill (search_apps) | 102 s | 20,858 | 3 | passed |
Prompt: Search F-Droid for Markor
Fixed skill ccfbcffd, 3/3 clean-reset phone B replays before AFTER retake. Original BEFORE retained. Original AFTER (69.47s/866042 tokens, success=True) preserved in originals/fdroid.mp4. New AFTER 101.53s/20858 tokens/3 calls, actual run_skill success. Every-frame terminal OCR and source-cast gate passed. AFTER was slower than BEFORE (101.53 vs67.18s): trace shows catalogue preparation/navigation71.29s, exact input verification7.23s, result readiness2.56s, collection9.62s. Token count fell from615049 to20858; no elapsed-time advantage is claimed.
One recorded pair on samsung-demo, claude-haiku-5-5; tokens count every input, cache and output token once per assistant message. Not a signed run: it adds no run evidence.
Demo shows: search_apps (query=podcast, limit=5)
Ghost in the Droid seed skill for the F-Droid client (
org.fdroid.fdroid). Read-only, no account.
| Action | What it does | Params |
|---|---|---|
search_apps | Search the catalogue, return names and summaries | query, limit |
open_app_page | Open an app page by package and read its details | package |
list_installed_apps | List installed apps F-Droid knows, with versions and update state | none |
browse_category | Open a category and list its first apps | category, limit |
The app: https://f-droid.org/F-Droid.apk (verify the signer). The skill:
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/fdroid
ghost skill run ghost/fdroid search_apps --param query="podcast" --param limit=5 --device emulator-5554
ghost skill run ghost/fdroid open_app_page --param package=org.wikipedia --device emulator-5554
run_skill(name="ghost/fdroid", action="open_app_page", params={"package": "net.gsantner.markor"})
# {"name": "Markor", "author": "Gregor Santner", "last_updated": "Mar 21", "size": "12.05 MB", "installed": true, ...}
Android 14 emulator (google_apis x86_64, 1080x2400, 420 dpi), F-Droid 2.0.1, en-US. Signed self-runs in runs/. License: MIT.
| App version | Android | Device | Skill version | Signed self-runs (pass/total) | Dates |
|---|---|---|---|---|---|
| 2.0.1 | 14 | Google/sdk_gphone64_x86_64 (emulator, 1080x2400, 420 dpi, en-US) | 1.0.0 | 12/12 | 2026-10-05 |
Physical-device launch attempts are also recorded on Samsung SM-A156B (Android 16, 1080×2340, en-US). Results remain action-specific; an attempt does not imply success. See the demos and current signed runs for evidence.
Untested so far: other OEM skins, other screen sizes and other locales.
None in the signed self-runs.
popup_detectors entry with its text and Got it.Search uses the actual editable field rather than a fixed toolbar coordinate. Existing text is replaced, and the visible input must equal the requested query. The validator also checks returned rows against that query. No install/update buttons are pressed.
A fresh F-Droid install downloads and imports its catalogue. Issuing a search during that import can leave an empty result until the query changes. The skill waits on Discover for initial import completion before searching, then waits for the bottom navigation to settle. It does not require an obsolete Apps heading. Initial import is bounded at 120s; result loading at 30s. A failed import or unmatched query fails explicitly. Queries must be typeable in the tested English UI.
Three consecutive clean-reset Markor searches passed on Android 16 Samsung SM-A156B, F-Droid 2.0.0, on 2026-11-03: 54.09s, 50.69s, 52.57s. Most time is catalogue import; a populated catalogue is faster. The earlier filmed agent's literal-{query} diagnosis was not confirmed: engine traces retain unresolved YAML even though dispatch interpolates it.
Version1.0.2 polls query readback for up to2s before submission. Search results still require a literal query token in visible title/summary; legitimate semantic-only matches can fail safely.
Recorded setup failure: a transient null foreground during launch caused the package guard to refuse before search. The current engine reads the full focused-window line and retries only an empty owner twice at100ms intervals; a denied package is still rejected immediately and persistent unknown focus still fails closed. Final CLI replays use that engine behavior.
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.
Package: org.fdroid.fdroid (F-Droid client, GPL-3.0)
Verified: 2026-10-05 on a headless emulator pool, Android 14 google_apis x86_64, 1080x2400 @ 420 dpi, F-Droid 2.0.1, en-US. Installed from https://f-droid.org/F-Droid.apk, signer SHA-256 43238d51...a9c9ccab.
Skill class: HARD. Read-only: the skill never installs, updates or removes apps. Needs network for the repo index.
F-Droid 2.x is Jetpack Compose: no resource ids. Bottom navigation texts Discover, Search, My apps. Secondary screens have a content-desc Back arrow. List rows put the app name directly above a one-line summary (or version, on My apps), both indented past the icon (left edge about 210 to 231 px); helpers pair texts whose edges touch.
Text in the raw XML is HTML-escaped (&), so labels with & cannot be matched by the engine's text: locator; helpers tap such chips from the Portal tree instead.
Coach marks seen once per install: Use filters to only show apps... and What are Anti-Features?, both closed with Got it; plus the Android 13+ notification permission prompt on first launch (denied).
search_apps(query, limit)Wait on Discover until initial catalogue import finishes (up to 120s). A search issued during import can retain an empty result even after the catalogue becomes ready. Wait for bottom Search navigation, then locate the actual android.widget.EditText, focus it, replace old text, and verify the input equals query. Submit and wait for matching result rows (up to 30s); an Apps heading is not required. Returns query plus results: [{name, summary}]. The validator rejects stale input and unrelated results.
open_app_page(package)VIEW https://f-droid.org/packages/<package>/ targeted at org.fdroid.fdroid opens the app page directly. Read: name (text just above by <author>), author, Last updated: <date> (<size>), the summary below it, and installed state (Installed badge or an Open button).
list_installed_apps()My apps tab: an optional All your apps are up to date card, then Installed apps with name and version rows. Scrolls to collect all. Returns apps, count, all_up_to_date.
browse_category(category, limit)Search tab with an empty query shows category chips (Browser, Calculator, Text Editor, ...). Scroll until the chip is visible, tap it; the category list has the category as its title and a Filter action. Returns the first limit rows.
popup_detectors entry with its text and Got it.Try a sample prompt or run an action by name. Replace any parameters in braces with your own values.
search_appsTry asking
ghost skill run ghost/fdroid search_apps open_app_pageTry asking
ghost skill run ghost/fdroid open_app_page list_installed_appsTry asking
ghost skill run ghost/fdroid list_installed_apps browse_categoryTry asking
ghost skill run ghost/fdroid browse_category 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.2latest | never | >=2.0.0 | pending | 26.1 KB | untagged |