npm install -g webdriverio-execute

which wdiox        # should print a path — if not, install first
wdiox --version    # confirms the binary works

# Browser
wdiox open https://example.com
wdiox snapshot                    # capture viewport elements → assigns e1, e2, …
wdiox snapshot --no-visible       # capture ALL elements (including off-screen)
wdiox click e3
wdiox fill e1 "hello@example.com"
wdiox screenshot /tmp/page.png
wdiox close

# Mobile (Appium)
wdiox open --app ./app.apk --device "emulator-5554"
wdiox snapshot                    # mobile elements → e1, e2, …
wdiox click e2
wdiox close

# Multi-session
wdiox open https://site-a.com --session a
wdiox open https://site-b.com --session b
wdiox snapshot --session a
wdiox ls                          # list all active sessions
wdiox close --session b

# Aliases
wdiox start / new                 # → open
wdiox stop                        # → close
wdiox type <ref> <text>           # → fill

wdiox open https://app.example.com/login
wdiox snapshot
# → e1  input[email]   "Email"     #email
# → e2  input[password] "Password" #password
# → e3  button          "Sign in"  button*=Sign in
wdiox fill e1 "user@example.com"
wdiox fill e2 "$PASSWORD"    # always use env vars for secrets
wdiox click e3
sleep 2                      # wait for page transition
wdiox snapshot               # re-snapshot on new page

wdiox open --app "app.apk" --device "emulator-5554" \
  && wdiox snapshot \
  && echo "---- Navigate to account ----" \
  && wdiox click e4 && sleep 1 && wdiox snapshot \
  && wdiox click e15 && sleep 1 && wdiox snapshot \
  && echo "---- Log in ----" \
  && wdiox click e2 && wdiox snapshot \
  && wdiox type e3 john@doe.com \
  && wdiox type e5 "$PASSWORD" \
  && wdiox click e10