← AnsightCONTENT HISTORY

Update to Ansight

Snapshot Sep 30, 2026 · 23:15 UTC · version 0.1.0

Collection source: not recorded for this historical snapshot.

WHAT CHANGED · RULE-BASED ANALYSIS

First saved snapshot

No earlier snapshot is available to establish a change.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "name": "ansight-install-dotnet",
  "description": "Install Ansight in a .NET MAUI, Android, iOS, or Mac Catalyst app with automatic local CLI-host registration and one-shot QR enrollment for physical devices. Add the all-in-one package, initialize at app startup, expose the SDK scanner from a developer-only surface, keep remote tools development-only, verify target builds, and inspect the app through the Ansight CLI.",
  "included_files": [],
  "skill_md_contents": "---\nname: ansight-install-dotnet\ndescription: Install Ansight in a .NET MAUI, Android, iOS, or Mac Catalyst app with automatic local CLI-host registration and one-shot QR enrollment for physical devices. Add the all-in-one package, initialize at app startup, expose the SDK scanner from a developer-only surface, keep remote tools development-only, verify target builds, and inspect the app through the Ansight CLI.\n---\n\n## OpenAI plugin integration\n\nRun Ansight CLI commands using the execution tools in ChatGPT Work or Codex on the machine that owns the resident host. If this environment cannot execute commands or reach that host, explain the missing prerequisite and do not claim a live inspection succeeded. A remote workspace or cloud agent does not automatically have access to the developer’s local host. Resolve relative helper paths from this skill’s directory. When this workflow references another bundled skill, read its local SKILL.md completely before following it.\n\nUse these bundled files for the canonical skill URLs referenced below; keep public URLs when writing documentation for the user’s app:\n\n- https://www.ansight.ai/skills/agents/ansight-app-inspection.md → [ansight-app-inspection](../ansight-app-inspection/SKILL.md)\n- https://www.ansight.ai/skills/dotnet/ansight-app-inspection-dotnet.md → [ansight-app-inspection-dotnet](../ansight-app-inspection-dotnet/SKILL.md)\n\n\n# Ansight .NET Install Skill\n\nUse this skill for .NET MAUI, .NET for Android, .NET for iOS, and .NET Mac\nCatalyst apps.\n\n## Workflow\n\n1. Identify the app project, target frameworks, startup path, debug guard, and\n   existing developer menu.\n2. For MAUI, install the all-in-one package:\n\n```shell\ndotnet add package Ansight.Maui --prerelease\n```\n\n   Then initialize before `builder.Build()`:\n\n```csharp\nbuilder.UseMauiApp<App>();\n\n#if DEBUG\nbuilder.UseAnsight<App>();\n#endif\n```\n\n   For non-MAUI apps, install `Ansight` and initialize:\n\n```csharp\n#if DEBUG\nvar options = Options.CreateBuilder()\n    .WithAnsightSdk()\n    .Build();\n\nRuntime.InitializeAndActivate(options);\n#endif\n```\n\n3. Add a developer-only scanner action:\n\n```csharp\nvar result = await Runtime.HostConnection.ConnectAsync(\n    HostConnectionRequest.QrCode());\n```\n\n4. If the app already owns a QR scanner, pass its text through\n   `HostConnectionRequest.PayloadText(...)`.\n5. Keep all-in-one and broad remote-tool packages in local-development builds.\n   Use a protected Release/CI policy for distributable builds.\n6. Add only platform privacy declarations needed by the scanner and local\n   network flow. Do not add an embedded resource, MSBuild-generated enrollment\n   file, certificate, or host address.\n7. Create or update `ansight-readme.md` with the scanner location, tool policy,\n   build checks, and CLI enrollment commands. Do not include an enrollment payload or token.\n8. Run `dotnet build` and relevant tests for every target changed.\n9. Start or reuse the resident CLI host. A simulator, emulator, Mac Catalyst,\n   or desktop build registers automatically. For a physical device, issue one\n   generic host QR and scan it from the developer-only surface:\n\n```sh\nansight host run\nansight pairing issue --qr\nansight session list --connected --app-id <app-id> --json\nansight app tools <session-id> --detail summary --include-unavailable --max-results 50 --json\n```\n\n   Do not require `ansight app register` before the first connection. After the\n   SDK has supplied its real App ID, optionally link that discovered app to its\n   repository with `ansight app register <app-id> --codebase <repository-path>`.\n\n## Enrollment Behavior\n\nHost-local targets register through automatic loopback and do not need a scan.\nThe first physical-device scan registers the installation and stores a random installation id\nand enrollment state in app-private storage. `HostConnectionRequest.Auto()` and\nnormal host auto-probe reconnect it on later developer launches.\n\n## Recommended Inspection Skills\n\nUse the main router to select the core inspection workflow. Add the .NET\ncompanion only when MAUI or .NET-specific semantics are material:\n\n```text\nhttps://www.ansight.ai/skills/agents/ansight-app-inspection.md\nhttps://www.ansight.ai/skills/dotnet/ansight-app-inspection-dotnet.md\n```\n"
}

SHA-256: 082a946ed6a6cf3dd866118d9372f4ad925a407e10d3db93d7e7dcd7bdad99cb