ada query — Query Session Data

The ada query command lets you query captured session data — traces, transcripts, screenshots, and metadata.

Common Commands

Session Info

ada query @latest time-info

Returns the session’s time boundaries and duration.

List Sessions

ada query --list-sessions

Shows all available captured sessions.

Voice Transcript

ada query @latest transcribe segments --limit 100 --format json

Returns transcribed voice segments as JSON. You can filter by time range:

ada query @latest transcribe segments --since 10 --until 30

Screenshot at Time

ada query @latest screenshot --time 15.5 --output /tmp/screen.png

Captures the screen at the specified timestamp (in seconds).

Trace Events

Query function call events by time range:

ada query @latest events --since-ns 1000000000 --until-ns 2000000000 --limit 100

Or filter by function name:

ada query @latest events --function "viewDidLoad" --limit 100

Output Formats

Most commands support --format json for structured output that’s easy to parse programmatically. This is how the /analyze skill consumes trace data.

Session Selectors

• @latest — the most recent session
• Session ID — a specific session by its identifier