/axiom:screenshot

Quick screenshot capture from booted iOS Simulator.

What It Does

Captures a screenshot of the currently booted simulator and displays it for analysis (Claude is multimodal!).

Usage

/axiom:screenshot

How It Works

1. Checks if a simulator is booted
2. Boots iPhone 16 Pro if needed
3. Captures screenshot to timestamped file: /tmp/axiom-screenshot-<timestamp>.png
4. Returns file path
5. Claude displays and analyzes the screenshot

Common Use Cases

Debug Visual Issues

/axiom:screenshot

Then ask: "Does the login button look centered?"

Verify Fixes

After making a change:

/axiom:screenshot

Then ask: "Is the text still clipped?"

Document Current State

/axiom:screenshot

Claude will capture and describe the current UI state.

Prerequisites

• An iOS Simulator must be booted
• If no simulator is running, command will boot one automatically

For More Control

For advanced simulator testing (location, push notifications, video recording, etc.), use:

/axiom:test-simulator

Or invoke the simulator-tester agent with natural language:

• "Test my app with location simulation"
• "Send a test push notification"
• "Record a video of the app"

Physical Devices and Scriptable Recording

/axiom:screenshot targets the simulator. To capture a physical device, or to record video with a clean auto-stop instead of Ctrl+C, use devicectl device capture — one -d <udid> selector works for both a simulator and a device (Xcode 26.6+):

xcrun devicectl device capture screenshot   -d <udid> --destination shot.png    # .png required
xcrun devicectl device capture screen-record -d <udid> --destination clip.mp4 --duration 5

See the Device Control reference (Screen capture) for codecs, mask policy, and the simctl / axe fallbacks.

Related

• /axiom:test-simulator – Full simulator testing with scenarios
• simulator-tester agent – Automated testing with visual verification
• Device Control reference – Unified devicectl capture for simulators and physical devices, plus fallbacks
• axiom-swift skill – Add navigation for better screenshot targeting

Example

# User runs command
/axiom:screenshot

# Claude responds:
"Screenshot captured: /tmp/axiom-screenshot-2025-12-08-14-30-45.png

Looking at the screenshot, I can see the login screen with the email and password fields. The 'Sign In' button appears centered and properly sized. The logo at the top is correctly positioned with adequate spacing."

Time saved: Instant visual verification without manual navigation.