Skip to content

ios-device: expose screenshot (client support already implemented) #103

Description

@onevcat

Context

PR #99 ships the experimental ios-device surface (devices / ui / tap). The accessibility audit channel exposes no element geometry, but it does serve screenshots: AXAuditClient.captureScreenshot() (selector deviceCaptureScreenshot) is already implemented and returns PNG data plus displayNativeScale and rotationRadians — it just isn't wired to any CLI verb.

Proposal

Add sim-use ios-device screenshot --output <path>, mirroring the simulator verb's flag vocabulary where it applies.

Notes

  • With no frames in the ui outline, a screenshot is the main way an agent can visually ground what the labels describe — likely the highest-value follow-up on this surface.
  • Surface the returned metadata (native scale, rotation) so downstream tooling can reason about orientation.
  • Update README and skills/sim-use/SKILL.md rule 4, which currently list screenshot as unavailable here.

Activity

  1. onevcat commented on Aug 27, 2026

    @onevcat
    ContributorAuthor

    Shipped in #118 — with one design change from this proposal: capture goes over CoreDevice (xcrun devicectl device capture screenshot) rather than the audit channel's captureScreenshot(). That turned out strictly better: no development-signing requirement (SpringBoard and system apps capture fine), ~2.8 s end-to-end, and no DTX session to tear down. The scale/rotation-metadata note is moot on this path (dimensions live in the PNG itself). AXAuditClient.captureScreenshot() remains implemented but unexposed. README and SKILL rule 4 were updated in the same PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions