Quickstart

From zero to a co-pilot driving all three platforms in a few minutes.

1. Install the daemon

The daemon hosts the MCP server, the driver registry, and the cockpit bridge.

git clone <your PilotStack repo>
cd PilotStack
pnpm install && pnpm build

2. Register the MCP server

Point Claude Code (or any MCP client) at the daemon over stdio.

claude mcp add pilotstack -- \
  node /ABS/PATH/PilotStack/daemon/dist/cli.js --mode co-pilot

Modes: manual (approve everything), co-pilot (approve mutations), auto-pilot (log only).

3. Boot devices & fly

Ask your agent to boot a web target, attach a running Android emulator, and bind a Flutter app's VM Service:

boot_web url=http://localhost:3000
attach_android
attach_flutter vmServiceUri=<from `flutter run`>
run_on_all action=screenshot   # all three, side by side

Meter your usage

Register a machine in the dashboard to get a ps_live_ key, then pass it so usage is billed to your org:

--api-url https://api.pilotstack.dev --api-key ps_live_…

Tool reference

Context (free, auto-run)

  • list_devices
  • get_ui_tree
  • get_layout
  • get_design_tokens
  • screenshot
  • compare_platforms

Driving (approval-gated)

  • tap / double_tap / long_press
  • swipe / drag / scroll
  • pinch / zoom
  • type_text / press_key
  • set_orientation / set_locale / set_text_scale
  • wait_for

Orchestration

  • boot_web
  • attach_android
  • attach_flutter
  • run_on_all