💻 Hello World — Ghost CLI

ghost "check reddit" --device asus — one line, real phone. No client to configure, no session to babysit. The killer one-liner.

Prerequisites

Ghost installed (pip install ghost-in-the-droid or pipx install ghost-in-the-droid)
A phone connected over ADB with USB debugging on (adb devices shows it)
An LLM brain configured (Claude Code subscription, ANTHROPIC_API_KEY, OpenRouter, or Ollama — see LLM Providers)

Step 1 — The one-liner

This is the exact command from the video:

ghost "Check what's on r/LocalLLaMA in the reddit app" --device asus

The ghost wakes the phone, opens Reddit, reads the screen, scrolls the subreddit, and reports back — all from a single shell line. --device takes any ADB serial or alias; leave it off if only one phone is connected.

Step 2 — Try your own prompt

Anything you’d tap by hand, the ghost taps for you:

ghost "Open Settings and tell me the battery percentage"
ghost "Take a selfie with a 3 second timer"

Prefer raw Python?

The CLI wraps the same Device class you can script directly:

from gitd.bots.common.adb import Device

dev = Device()                      # auto-detects a single connected phone
dev.adb("shell", "input", "keyevent", "KEYCODE_WAKEUP")
dev.adb("shell", "am", "start", "-n", "com.android.settings/.Settings")

xml = dev.dump_xml()                # read the UI hierarchy
nodes = dev.find_nodes(xml, text="Network")
if nodes:
    dev.tap_node(nodes[0])          # the ghost taps

Save as hello.py, run python3 hello.py, and watch Settings open on the phone.

What next?

CLI Reference — every entry point and env var
Record Macros — record taps once, replay at any speed
Skill System — turn one-liners into reusable skills
Dashboard — the same power, in the browser

Try another approach →

MCP + Claude Code · MCP + Codex · MCP + Antigravity · LangChain · Web Chat · On-Device Android · On-Device iPhone · iPhone Duolingo