ghost/code-word

Code Word (F-Droid) Wordle-style word game: start a new puzzle, type a guess, read the guesses made. The per-letter feedback is only a colour (not readable); an agent reads it from a screenshot. Offline, no account.

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

Token savings

98% fewer tokens
Tokenswithout1,636,599with39,360 (98% fewer)
Timewithout111 swith83.3 s (25% less time)
Tool callswithout37with5 (86% 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_puzzle · live agent session on a real phone

Control Code Word on Android with an AI agent — play Wordle-style word puzzles

Control Code Word on Android with an AI agent. Play a Wordle-style word game on your phone: an agent starts a puzzle, types guesses and reads which words it has tried.

Target search phrase: AI agent plays Wordle on Android

Demo shows: guess (word=crane)

Ghost in the Droid seed skill for Code Word (com.peaceray.codeword), an offline Wordle-style word game (secret word, 6 guesses). The typed guesses are readable; the per-letter feedback is only a tile colour and is NOT in the accessibility tree. Offline, no account.

ActionWhat it doesParams
new_puzzleStart a fresh puzzle (5 letters, 6 guesses) and return the seednone
guessType a word and submit it; reports whether the row was acceptedword
get_boardRead the guesses made so far, word length and rowsnone

Toolkit

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

RoleAction
Entrynew_puzzle
Primitivesguess
Read stateget_board (letters only, NOT the colour feedback)

Install

The app: F-Droid, or https://f-droid.org/packages/com.peaceray.codeword/. 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/code-word

Use

ghost skill run ghost/code-word new_puzzle --device <serial>
ghost skill run ghost/code-word guess --param word=crane --device <serial>
run_skill(name="ghost/code-word", action="guess", params={"word": "crane"})
# {"result": {"word": "CRANE", "accepted": true, "board": {"typed_rows": ["CRANE"], ...}}}

Try asking: "Start a new Code Word puzzle and guess crane, then pound."

Tested on

Real Samsung phone, Android 13 (720x1600, 300 dpi, en-GB), Code Word 1.4.4. License: MIT.

Known failure modes and versions tested

Versions tested

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

Recorded failures

  • HONEST LIMIT: the per-letter colour feedback is not readable from the accessibility tree; use a screenshot.
  • Words the dictionary does not know are rejected by the app; the row stays empty and accepted is false.
  • The guess length must match the puzzle (5 letters by default).
  • The first-run How to play dialog is closed automatically.
  • A guess the app does not accept (not in its dictionary) is reported as a failed guess (accepted: false fails the step).

Popups and first-run screens handled

  • The How to play dialog is closed by the open_game subroutine.

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

new_puzzle

Play demo

Try asking

  • Start a new word puzzle
  • play a Wordle-style game
  • new word guessing game
ghost skill run ghost/code-word new_puzzle

guess

Play demo

Try asking

  • Guess the word CRANE
  • try the word pound
  • guess stone
ghost skill run ghost/code-word guess

get_board

Play demo

Try asking

  • What have I guessed so far?
  • show my guesses
  • how many guesses are left
ghost skill run ghost/code-word get_board