new_puzzle
Play demoTry asking
- Start a new word puzzle
- play a Wordle-style game
- new word guessing game
ghost skill run ghost/code-word new_puzzle 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.
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.
42× fewer tokens, 1.3× faster with the skill. Agent run: stopped early without the skill, finished with it (not independently checked).
| Run | Time | Tokens | Tool calls | Result |
|---|---|---|---|---|
| No skill: agent drives by hand | 111 s | 1,636,599 | 37 | stopped early |
| With skill: find_skill, run_skill | 83.3 s | 39,360 | 5 | finished |
Prompt: Play Code Word on my phone: start a new puzzle, then guess the words crane and pound. Do not use the Play Store, no installs, no sign-in.
Same prompt, same phone, clean app state per side. Left: no skill, the agent drives the UI by hand. Right: find_skill + run_skill. 'ok' means the agent finished its turn; the result was not independently checked.
One recorded pair on samsung-a03s, claude-haiku-5-5; tokens count every input, cache and output token once per assistant message. Not a signed run: it adds no run evidence.
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.
| Action | What it does | Params |
|---|---|---|
new_puzzle | Start a fresh puzzle (5 letters, 6 guesses) and return the seed | none |
guess | Type a word and submit it; reports whether the row was accepted | word |
get_board | Read the guesses made so far, word length and rows | none |
An agent can drive the whole app with these; compose them.
| Role | Action |
|---|---|
| Entry | new_puzzle |
| Primitives | guess |
| Read state | get_board (letters only, NOT the colour feedback) |
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
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."
Real Samsung phone, Android 13 (720x1600, 300 dpi, en-GB), Code Word 1.4.4. License: MIT.
| App version | Android | Device | Skill version | Dates |
|---|---|---|---|---|
| 1.4.4 | 13 | Samsung real phone (720x1600, 300 dpi, en-GB) | 1.0.0 | 2026-11-02 |
SOFT.md is the narrative an agent reads when the exact steps no longer match your app version and it has to adapt the skill.
What each action means, which UI landmarks it relies on and how success is recognised, so an agent can adapt it to another app of this kind or another version.
Package: com.peaceray.codeword (Code Word, GPL-3.0, version 1.4.4 from the official F-Droid repository, sha256-verified)
Verified: 2026-11-02 on a real Samsung phone, Android 13, 720x1600 @ 300 dpi, en-GB. Offline, no account.
Skill class: HARD. No login, no checkpoints.
textView nodes (blank tiles are a space); the keyboard keys are keyTextView; the submit key is the right-most FrameLayout of the bottom row. action_puzzle_info opens the puzzle dialog whose NEW PUZZLE button leads to a Daily/Seeded/Custom screen with a PLAY button (createPuzzleButton) and the seed.new_puzzle()Puzzle Info > NEW PUZZLE > PLAY with the default settings. Success: empty board, keyboard visible.
guess(word)Taps each letter key, then the submit key. accepted is true when the typed row appears in the board; a non-word is rejected by the app and the row stays empty.
get_board()Reads the letter tiles row by row.
To use the feedback an agent needs vision: take a screenshot after each guess (blue/green = right place, yellow = elsewhere, grey = absent).
Try a sample prompt or run an action by name. Replace any parameters in braces with your own values.
new_puzzleTry asking
ghost skill run ghost/code-word new_puzzle guessTry asking
ghost skill run ghost/code-word guess get_boardTry asking
ghost skill run ghost/code-word get_board Each release is an immutable git tag. The tree hash pins the exact skill directory the installer verifies.
| Version | Released | App versions | Tree | Size | Provenance |
|---|---|---|---|---|---|
1.0.0latest | never | >=1.4.4 | pending | 13.5 KB | untagged |