ghost/game-2048

2048 (Privacy Friendly, F-Droid): start a new game, swipe left/right/up/down (single or a sequence), restart and read the 4x4 grid, points and record. Offline, no account.

Proven 36× fewer tokens Score 41/100 Official hard skill python

Token savings

97% fewer tokens
Tokenswithout1,635,574with46,033 (97% fewer)
Timewithout79.8 swith21.1 s (74% less time)
Tool callswithout27with4 (85% 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: new_game · live agent session on a real phone

Control 2048 (Privacy Friendly) on Android with an AI agent

Control 2048 (Privacy Friendly) on Android with an AI agent. Play 2048 on your phone: an agent swipes the tiles and reads the board and the score.

Target search phrase: AI agent plays 2048 on Android

Demo shows: new_game (directions=left,up,left,down,left,up)

Ghost in the Droid seed skill for 2048 (Privacy Friendly) (org.secuso.privacyfriendly2048), the classic 2048 puzzle from the SECUSO privacy-friendly apps (no permissions, no ads). Offline, no account.

ActionWhat it doesParams
new_gameStart a new 4x4 game and return the boardnone
swipeSwipe left/right/up/down once on the game in progressdirection
play_movesNew game, then a sequence of swipesdirections
restartRestart the running gamenone
get_boardRead the grid, points, record, tile sum, max tile, game overnone

Toolkit

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

RoleAction
Entrynew_game
Primitivesswipe, play_moves, restart
Read stateget_board

Install

The app: F-Droid, or https://f-droid.org/packages/org.secuso.privacyfriendly2048/. 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/game-2048

Use

ghost skill run ghost/game-2048 new_game --device <serial>
ghost skill run ghost/game-2048 swipe --param direction=left --device <serial>
run_skill(name="ghost/game-2048", action="get_board")
# {"board": {"grid": [[2,0,0,0],[8,2,0,0],[0,0,0,0],[0,0,0,0]], "points": 16, "record": 16, "max_tile": 8}}

Try asking: "Start a new 2048 game and swipe left, up, left, down, left, up."

Tested on

Real Samsung phone, Android 13 (720x1600, 300 dpi, en-GB), 2048 (Privacy Friendly) 1.4.2. License: MIT.

Known failure modes and versions tested

Versions tested

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

Recorded failures

  • Tiles spawn at random: never assert exact tiles, assert points >= before and tile sum >= before.
  • A swipe that cannot move changes nothing; the helper still reports before/after.
  • The record survives restarts but not pm clear.
  • The welcome slides only show on the first launch after install or clear (SKIP is handled).

Popups and first-run screens handled

  • The first-run welcome (btn_skip) is handled in the open_menu subroutine.

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

new_game

Play demo

Try asking

  • Start a new 2048 game
  • play 2048
  • new game of 2048
  • restart the 2048 board
ghost skill run ghost/game-2048 new_game

swipe

Play demo

Try asking

  • Swipe left in 2048
  • slide the tiles down
  • move up in 2048
ghost skill run ghost/game-2048 swipe

play_moves

Play demo

Try asking

  • Play 2048: swipe left, up, left, down, left, up
  • play a few moves of 2048
  • swipe left then up four times
ghost skill run ghost/game-2048 play_moves

restart

Play demo

Try asking

  • Restart the 2048 game
  • start over
ghost skill run ghost/game-2048 restart

get_board

Play demo

Try asking

  • What does my 2048 board look like?
  • what is my 2048 score
  • what is the biggest tile
ghost skill run ghost/game-2048 get_board