Setup

The primary way agents drive sootsim is the sootsim CLI — same binary you already use, no separate agent install.

npm i -g sootsim

That’s it. From inside any agent (Claude Code, Cursor, Codex, anything that can run shell commands), sootsim describe, sootsim do tap-text "Sign in", and the rest of the CLI just work against whatever sim is running.

Verifying

With a sim open:

sootsim list           # should show at least one connected tab
sootsim describe       # dumps the current screen

If list is empty, start a sim first (sootsim open <port> or your usual dev flow), then retry.

Skills

We ship a handful of skill files that teach agents how to use sootsim well — debugging, accessibility, perf, visual regression, test flow authoring. Drop one into your repo and any compatible agent picks it up automatically.

Two ways to install:

# generic — works in any agent-aware repo
npx skills add tamagui/soot --skill sootsim-debug
npx skills add tamagui/soot --skill sootsim-a11y

# from a soot checkout
bun sootsim skills <target-dir>

Available: sootsim-debug, sootsim-a11y, sootsim-perf, sootsim-visual, sootsim-test-flow, sootsim-maestro, sootsim-detox. Pick what matches your task.

See the skills CLI docs for the generic flow.

What’s next

• CLI Use — the day-to-day commands an agent runs.
• Agent Devtool (Inspect) — the in-sim panel where you talk to an agent and watch it work.