---
name: ansight-app-inspection-flutter
description: Use this skill when inspecting, debugging, verifying, or extracting evidence from a running Flutter iOS or Android app through the Ansight CLI. Discover Flutter widget tools, native visual-tree and data tools, logs, telemetry, screenshots, and artifacts with structured commands before direct simulator or device access.
---

# Ansight Flutter App Inspection Skill

Use this skill for a Flutter 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 structured evidence with the relevant `ansight session show`, `session logs`, `session images`, `session metrics`, `session trees`, or `session artifacts` command and add `--json` before mutating anything.
4. Discover the live catalog with `ansight app tools <session-id> --json`. Look for:
   - `flutter.get_widget_tree`, `flutter.inspect_widget`, `flutter.find_widgets`, `flutter.get_navigation_state`;
   - native `ui.*`, `data.*`, `files.*`, `prefs.*`, `secure.*`, `reflect.*`;
   - `artifacts.query` and `artifacts.request`;
   - app-specific tools.
5. Use Flutter tools for mounted widget/render-object state and native `ui.*` tools for platform hierarchy and screenshots.
6. Use read tools first. Call write/delete tools only when the user asked for a mutation and the returned catalog permits it.
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 Flutter tooling, Xcode, `adb`, a simulator, or a physical device only when the CLI host lacks the needed evidence; state why.

## Physical iPhone and iPad Logs

A paired development build can stream app-provided lines, Ansight SDK diagnostics, telemetry, screenshots, touches, and tool results from the physical device. Use Xcode device logging for full OS/process console output that the app did not send through Ansight.

## Output

Report the selected app/session, tools used, time windows, evidence, conclusion, mutations performed, and any fallback.