Start

Quick start

# 1. install (Node 18+; zero dependencies)
npm install -g @looktap/cli

# 2. check the toolchain
looktap doctor

# 3. boot a device: an iOS simulator…
xcrun simctl boot "iPhone 16" && open -a Simulator
#    …or an Android emulator
$ANDROID_HOME/emulator/emulator -avd Pixel_9a &

# 4. drive it
looktap launch com.apple.Preferences --ls     # (Android: com.android.settings)
looktap tap "General" --ls
looktap shot general

Or try it without installing anything: npx @looktap/cli doctor (any command works the same way).

To teach Claude Code how to use looktap, install the plugin. In Claude Code:

/plugin install looktap --marketplace lakpriya1s/looktap

It adds the looktap skill. Then run /looktap:setup: it installs the CLI, checks your toolchain and gets a device ready. Or copy the skill in by hand:

looktap skill --install      # → ~/.claude/skills/looktap/SKILL.md

Other ways to install

The latest from GitHub, ahead of the npm release:

npm install -g github:lakpriya1s/looktap

From a checkout:

git clone https://github.com/lakpriya1s/looktap.git
cd looktap && npm install -g .

As a tarball you can hand to someone (it includes both prebuilt helpers):

npm pack                                  # → looktap-cli-<version>.tgz
npm install -g looktap-cli-<version>.tgz  # on their machine

Without installing: node bin/looktap.js --help.

Uninstall: npm uninstall -g @looktap/cli && rm -rf ~/.looktap.

🤖 Kickstart with your AI agent

Paste this into your AI coding agent (Claude Code, Cursor, Codex, opencode, …) and let it set things up and start using the app with you:

Install looktap (https://github.com/lakpriya1s/looktap) so you can drive
my app in the iOS simulator / Android emulator:

1. Run `npm install -g @looktap/cli`, then `looktap doctor`,
   and fix anything it reports (boot a simulator or emulator, or connect a device, if none is up).
2. Run `looktap skill --install` and read the skill it installs.
3. Find my app's bundle id / package name in this repo and write a
   looktap.config.json with it at the repo root.
4. Launch the app with `looktap launch --ls` and tell me what screen it's on.

Rules: never type real credentials, OTPs or card numbers. When the app needs a
sign-in, stop and let me do it, then continue from there.

Requirements

For	You need
Everything	Node 18+ (`node -v`)
iOS	A Mac with Xcode (command-line tools selected) and at least one simulator runtime. Apple Silicon or Intel
Android	Android SDK platform-tools (`adb` on your `PATH`), and an emulator (AVD) or a USB-debugging device
A real iPhone or iPad	The iOS row, plus an Apple ID signed in to Xcode (a free one works) and the device paired with the Mac, with Developer Mode on. See Using a real iPhone

Tested with Xcode 26 / iOS 26 (iPhone 14 simulator) and Android 16 / API 36 (Pixel 9a emulator).

Generated from README.md. Edit it there.

Quick start

#🤖 Kickstart with your AI agent

#Requirements

🤖 Kickstart with your AI agent

Requirements