---
name: ansight-app-inspection-cordova
description: Use this skill when inspecting, debugging, verifying, or extracting evidence from a running Cordova-family Capacitor app through the Ansight CLI. Discover DOM and native visual trees, logs, telemetry, screenshots, artifacts, and data tools with structured commands before direct device access.
---

# Ansight Cordova / Capacitor App Inspection Skill

Use this skill for a Capacitor app paired with the resident Ansight CLI host.

## Workflow

1. Confirm CLI access with `ansight host status --json`; load `https://www.ansight.ai/skills/ansight-cli-setup.md` if setup is required.
2. Run `ansight app list --json` and `ansight session list --connected --json`; select by app id, device, or explicit user context.
3. Read evidence first with the relevant `ansight session show`, `session logs`, `session images`, `session metrics`, `session trees`, or `session artifacts` command and add `--json`.
4. Discover the live catalog with `ansight app tools <session-id> --json`. Look for:
   - `dom.get_document`, `dom.inspect_node`, `dom.query_selector`, optional `dom.invoke_action`;
   - native `ui.*`, `data.*`, `files.*`, `prefs.*`, `secure.*`, `reflect.*`;
   - `artifacts.query`, `artifacts.request`, and app-specific tools.
5. Use `dom.*` for HTML/WebView state and native `ui.*` for the platform container hierarchy and screenshots.
6. Use read tools first. Invoke DOM actions or other mutations only when requested and permitted by the returned catalog.
7. Correlate conclusions with at least two evidence types when practical.
8. Invoke returned tools with `ansight app call <session-id> <tool-id> --arguments-file <path> --json`. Fall back to browser devtools, Xcode, `adb`, simulator/emulator, or physical device only when the CLI host lacks the evidence; state why.

## Physical iPhone and iPad Logs

A paired development build can stream app-provided lines, captured JavaScript errors, Ansight SDK diagnostics, telemetry, screenshots, touches, and tool results. Use Xcode for complete device and OS console logs.

Report the selected app/session, evidence, tools used, conclusion, mutations, and fallbacks.
