ghost/shopping-list

Shopping List app (F-Droid): add items with a quantity, add several at once, read the whole list back. Offline, no account.

Proven 78× fewer tokens Score 38/100 Official hard skill python

Token savings

99% fewer tokens
Tokenswithout1,578,860with20,240 (99% fewer)
Timewithout59.8 swith18.6 s (69% less time)
Tool callswithout27with3 (89% fewer)

Agent run: stopped early without the skill, finished with it (not independently checked).

One recorded run each way, claude-haiku-5-5, same phone and same prompt. Watch it in the Before / after tab.

Recorded: add_item · live agent session on a real phone

Control Shopping List on Android with an AI agent

Control Shopping List on Android with an AI agent. Add items to your shopping list, tick them off and clear the bought ones from your phone by asking an agent.

Target search phrase: AI agent shopping list Android

Demo shows: add_item (name=Milk, quantity=2)

Ghost in the Droid seed skill for Shopping List (com.woefe.shoppinglist), a FOSS offline shopping list from F-Droid. Offline, no account.

ActionWhat it doesParams
add_itemAdd one item with an optional quantityname, quantity
add_itemsAdd several comma separated itemsitems
get_itemsReturn every item with its quantitynone
check_itemToggle an item's checked (grey) state by tapping its rowname
remove_checkedDelete all checked items (needs confirm=yes)confirm

Toolkit

An agent can drive the whole app with these; compose them.

RoleAction
Entryadd_item
Primitivesadd_items, check_item, remove_checked
Read stateget_items

Install

The app: F-Droid, or https://f-droid.org/packages/com.woefe.shoppinglist/. 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/shopping-list

Use

ghost skill run ghost/shopping-list add_item --param name=Milk --param quantity=2 --device <serial>
ghost skill run ghost/shopping-list get_items --device <serial>
run_skill(name="ghost/shopping-list", action="get_items")
# {"items": [{"name": "Milk", "quantity": "2"}]}

Try asking: "Add milk, eggs and bread to my shopping list."

Tested on

Real Samsung phone, Android 13 (720x1600, 300 dpi, en-GB), Shopping List 0.11.0. License: MIT.

Known failure modes and versions tested

Versions tested

App versionAndroidDeviceSkill versionDates
0.11.013Samsung real phone (720x1600, 300 dpi, en-GB)1.0.02026-11-02

Recorded failures

  • The add panel stays open between runs: get_items presses BACK until the add button is visible.
  • Quantity is passed as text; digits from CLI callers arrive as ints, the helper stringifies them.
  • Checked (grey) items are not read back: the app does not expose the state.

Popups and first-run screens handled

  • None: the app has no first-run screens and asks for no permissions.

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

add_item

Play demo

Try asking

  • Add milk to my shopping list
  • put eggs on the shopping list
  • add 3 apples to my groceries
  • I need bread, add it to the list
ghost skill run ghost/shopping-list add_item

add_items

Play demo

Try asking

  • Add milk, eggs and bread to my shopping list
  • add rice, beans and salt to the shopping list
  • buy tomatoes and onions
ghost skill run ghost/shopping-list add_items

get_items

Play demo

Try asking

  • What is on my shopping list?
  • read my shopping list
  • what do I still need to buy
ghost skill run ghost/shopping-list get_items

check_item

Play demo

Try asking

  • Tick off milk on my shopping list
  • mark eggs as bought
  • cross bread off the list
ghost skill run ghost/shopping-list check_item

remove_checked

Play demo

Try asking

  • Remove the items I already bought from my shopping list
  • clear the bought items
  • delete checked items from the list
ghost skill run ghost/shopping-list remove_checked