ghost/vector-pinball

Vector Pinball (F-Droid): pick a table, start a game, launch the ball, work the flippers, end the game, read high scores. Offline, no account.

Proven 52× fewer tokens Score 39/100 Official hard skill python

Token savings

98% fewer tokens
Tokenswithout1,531,860with29,424 (98% fewer)
Timewithout76.0 swith19.4 s (75% less time)
Tool callswithout30with4 (87% 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: start_game · live agent session on a real phone

Control Vector Pinball on Android with an AI agent

Control Vector Pinball on Android with an AI agent. Play pinball on your phone: an agent picks a table, launches the ball and works the flippers.

Target search phrase: AI agent plays pinball on Android

Demo shows: start_game (side=both, times=6)

Ghost in the Droid seed skill for Vector Pinball (com.dozingcatsoftware.bouncy), a free vector-graphics pinball game from F-Droid that runs fully offline. Offline, no account.

ActionWhat it doesParams
start_gameStart a game on the chosen table and launch the balltable_steps, unlimited_balls
flipHit the left, right or both flippers N timesside, times
end_gameEnd the running game and return to the main menunone
select_tableStep to the next/previous table on the main menusteps
get_statusRead state (menu, playing, paused), table label and high scoresnone

Toolkit

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

RoleAction
Entrystart_game
Primitivesflip, select_table, end_game
Read stateget_status

Install

The app: F-Droid, or https://f-droid.org/packages/com.dozingcatsoftware.bouncy/. 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/vector-pinball

Use

ghost skill run ghost/vector-pinball start_game --device <serial>
ghost skill run ghost/vector-pinball flip --param side=both --param times=6 --device <serial>
run_skill(name="ghost/vector-pinball", action="get_status")
# {"status": {"state": "playing"}}

Try asking: "Start a pinball game and hit both flippers a few times."

Tested on

Real Samsung phone, Android 13 (720x1600, 300 dpi, en-GB), Vector Pinball 1.16.0. License: MIT.

Known failure modes and versions tested

Versions tested

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

Recorded failures

  • The score is painted, not text: get_status cannot return it. It reports the state and high scores only.
  • Reopening the app pauses nothing, but a running game hides the menus: every action first reaches the main menu (pause > END GAME).
  • Gameplay is real time: flips are fire-and-forget taps, the ball may drain between calls.

Popups and first-run screens handled

  • None: no first-run screens, no permissions.

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

start_game

Play demo

Try asking

  • Start a pinball game
  • play pinball
  • launch a pinball ball
  • start the pinball table
ghost skill run ghost/vector-pinball start_game

flip

Play demo

Try asking

  • Flip both pinball flippers five times
  • work the left flipper three times
  • keep the ball alive with the flippers
ghost skill run ghost/vector-pinball flip

end_game

Play demo

Try asking

  • End the pinball game
  • quit this pinball game
  • stop playing pinball
ghost skill run ghost/vector-pinball end_game

select_table

Play demo

Try asking

  • Switch to the next pinball table
  • choose a different table
  • previous pinball table
ghost skill run ghost/vector-pinball select_table

get_status

Play demo

Try asking

  • What are my pinball high scores?
  • is a pinball game running
  • show the pinball high scores
ghost skill run ghost/vector-pinball get_status