ghost/tasks

Tasks.org (F-Droid), local lists only: add a task, list open tasks, search, mark a task done. No account, no sync.

Runs 2.5× fewer tokens Score 37/100 Official hard skill python

Token savings

60% fewer tokens
Tokenswithout145,510with58,333 (60% fewer)
Timewithout17.8 swith18.6 s (4% more time)
Tool callswithout13with4 (69% fewer)

Task check: passed without the skill, passed with it.

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

Demo: add_task · HOME → launch → action

Control Tasks on Android with an AI agent — manage to-do lists

Demo shows: add_task (title=Water the plants)

Ghost in the Droid seed skill for Tasks.org (org.tasks), a FOSS to-do app from F-Droid. Local lists only: no account, no sync.

ActionWhat it doesParams
add_taskNew task in the default local listtitle, notes
list_tasksOpen tasks with notes and sectionnone
search_tasksTasks matching a textquery
complete_taskTick a task by exact titletitle

Install

Install the app from F-Droid (org.tasks), then:

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/tasks

Use

ghost skill run ghost/tasks add_task --param "title=Buy stamps" --device emulator-5554
ghost skill run ghost/tasks complete_task --param "title=Buy stamps" --device emulator-5554

From any MCP agent:

run_skill(name="ghost/tasks", action="list_tasks")
# {"tasks": [{"title": "Call the bank", "notes": "about the card", "section": "No due date"}], "count": 1}

Tested on

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

Notes

The editor's Save button is in the top toolbar; the skill taps it only when no heads-up notification is showing. Tasks are never deleted. License: MIT (the skill; the app is GPL-3.0).

Known failure modes and versions tested

Versions tested

App versionAndroidDeviceSkill versionSigned self-runs (pass/total)Dates
15.1214Google/sdk_gphone64_x86_64 (emulator, 1080x2400, 420 dpi, en-US)1.0.012/122026-10-05

Android 13 was additionally replayed on a 720x1600 Samsung SM-A037F (300 dpi, en-GB) and a 1080x2400 emulator (420 dpi, en-US). See the cross-device report for measured outcomes and limitations; other profiles remain unverified.

Recorded failures

The historical runs above were green. Samsung failures and subsequent fixes are recorded in the cross-device report.

Popups and first-run screens handled

  • First-run account choice (local lists)
  • Enable-reminders banner
  • Notification permission prompt

Other known failure modes

  • With "show completed" on, completed tasks stay visible with a strike-through; complete_task would then need a checked-state check.
  • Duplicate titles: complete_task ticks the first match.

On OEMs without the AOSP pinned-notification field, toolbar taps require Tasks focus and an independently unobscured target. Compose controls additionally use the focused window bounds and every higher visible window; unknown geometry or an overlap refuses the tap.

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

add_task

Play demo

Try asking

  • Add a task to water the plants
  • remind me to buy stamps
  • new todo: call the bank, about the card
  • put renew passport on my task list
ghost skill run ghost/tasks add_task

list_tasks

Play demo

Try asking

  • What's on my to-do list?
  • list my tasks
  • what do I still need to do
  • show open todos
ghost skill run ghost/tasks list_tasks

search_tasks

Play demo

Try asking

  • Find my task about stamps
  • search tasks for bank
  • do I have a todo about plants
  • look up passport in my tasks
ghost skill run ghost/tasks search_tasks

complete_task

Play demo

Try asking

  • Mark water plants as done
  • I bought the stamps, tick it off
  • complete the task call the bank
  • check off renew passport
ghost skill run ghost/tasks complete_task