iteration

Study ID

Workspace ID; accepted for consistency (workspace is inferred from the study)

Study ID (or set via ish study use)

Workspace ID; accepted for consistency (workspace is inferred from the study)

Iteration name (defaults to the next position letter A/B/C… if omitted)

Iteration description

Platform (browser, android, ios, figma, code) - interactive only

URL to test - interactive only (optional for ios/android native apps)

Native app bundle id (or .app/.apk path) - ios/android; supplies the iteration target so —url isn’t required

Screen format (mobile_portrait, desktop) - interactive only; hyphen/underscore variants accepted. Default: desktop, or mobile_portrait for native ios/android

Locale code (e.g. en-US) - interactive only

Figma file key - required when —platform=figma

Figma start node id - required when —platform=figma

Figma flow name - interactive only

Text content (treated as markdown → canonical content_doc), or @filepath to read from file - text modality

Paste-exact HTML (e.g. a branded email), or @filepath - text modality. Rides as the ADR-0015 format:html carrier (rendered source-faithful, re-sanitized backend-side). Mutually exclusive with —content-md / —content-text.

Markdown content, or @filepath to read from file - text modality. Parsed to the canonical content_doc block AST (ish.doc/1). Mutually exclusive with —content-text.

Email ‘From’ display name - text modality (email rendering)

Email sender address - text modality (email rendering)

Hero image URL - text modality (email rendering)

URL or local file path to media file - video, audio, document modalities

Comma-separated image URLs or local file paths - image modality

Content title shown to participants (the leading headline they read) - media modalities

MIME type (e.g. video/mp4) - media modalities

Ad copy or social post caption (or @filepath) - ads & social posts

HTML version of copy text (or @filepath)

Social platform (instagram, tiktok, facebook, linkedin, x)

Copy position relative to media (before, after) Default: “after”.

Segmentation JSON. Text (content_doc, ADR-0015) is block-id based: heading_based {split_level} auto-splits at headings (the default - author one ## per section), or section_based {sections[{segment_id,name,label,start_block_id}]} for manual block-id boundaries (first section may omit start_block_id). Video/audio: time_based {intervals_seconds, labels?}. Sections are SEMANTIC (a long article is usually 3-6, not one per block). NOTE: the old paragraph_start/end form is DEAD on content_doc - it errors every participant at run; use heading_based or start_block_id.

Content config JSON - {early_termination, selected_segment_indices?} - media modalities

Chat mode: external_chatbot (default; probe a customer chatbot) or participant_pair (two AI people talk to each other)

Saved chatbot endpoint id - chat modality, external_chatbot mode (legacy; prefer —endpoint)

Inline chatbot endpoint config JSON - chat modality, external_chatbot mode (legacy; prefer —endpoint-config)

Max participant turns (1-50) - chat modality (default 12)

End the chat session early when the participant signals stop - chat modality

Saved chatbot endpoint id (alias or UUID) - chat modality, external_chatbot mode

Raw ChatbotEndpointConfig JSON file or - for stdin - chat modality, external_chatbot mode

Person IDs/aliases for side A (comma-separated or repeatable). Pass a single person and N on —group-b to broadcast (1×N rehearsal: fix side A, vary side B) - chat participant_pair mode Default: [].

Person IDs/aliases for side B (comma-separated or repeatable). When both sides are explicit they must be equal length, BUT if either side is a singleton it’s auto-broadcast to match the other (1×N rehearsal) - chat participant_pair mode Default: [].

Side-A scenario + goal text, or @filepath - chat participant_pair mode

Side-B scenario + goal text, or @filepath - chat participant_pair mode

Which side speaks first (default: a) - chat participant_pair mode

RoleCriteria filter for side A (inline JSON or @filepath). Keys: occupation[], min_age, max_age, gender[], country[], education_level_in[], household_in[], locale_type_in[], income_level_in[], employment_status_in[], requires_captions, uses_screen_reader, prefers_reduced_motion, prefers_high_contrast, has_any_accessibility_need. The five *_in arrays accept snake_case spec values; the five accessibility filters are booleans. Person-first: filters the eligible person pool without altering the people themselves. Use INSTEAD of —group-a or alongside it (criteria then validates the explicit list). chat participant_pair mode.

RoleCriteria filter for side B - same shape as —role-criteria-a. chat participant_pair mode.

Raw iteration details JSON (overrides individual flags)

Iteration ID(s) - one or more aliases/UUIDs (space- or comma-separated) (required, variadic)

Workspace ID; accepted for consistency (inferred from alias / active context)

Iteration ID (required)

Iteration name

Iteration description

Iteration details as JSON string

Iteration label (uppercase letters)

Workspace ID; accepted for consistency (inferred from alias / active context)

Iteration ID (required)

Skip confirmation prompt (required in —json / non-TTY)

Workspace ID; accepted for consistency (inferred from alias / active context)

output the version number

Auth token (or set ISH_TOKEN env var)

Read auth token from a file (preferred over —token / ISH_TOKEN)

Default workspace ID; per-subcommand —workspace overrides

Output as JSON (auto-enabled when piped)

Extract a single field from the JSON response and print only its value (implies —json internally; supports dotted paths e.g. person.name)

Force human-readable output even when stdout is piped (overrides JSON-when-piped auto-detection)

Comma-separated fields to include in JSON output (e.g. alias,name,status)

Print the projectable field names for the response instead of the data, then exit (also: —fields ?)

Include full UUIDs and timestamps in JSON output

Disable colored output (also honored: NO_COLOR env var)

Suppress progress messages on stderr (no-op for read commands that emit none)