qualtrics-cliQualtrics CLI

Agent-friendly CLI for the Qualtrics Experience Management Platform & offline survey compiler.

Guide

GitHub

Offline Survey Compiler

Compile plain-text Markdown survey specs directly to .qsf files with zero API access needed.

Full Survey Platform

Complete coverage of surveys, questions, blocks, flows, options, distributions, and contacts.

Async Response Jobs

Asynchronous response exports and imports with automatic polling, progress, and archive extraction.

Safety Model

--dry-run, --confirm, and --read-only gates on all mutations and destructive actions.

Agent-First Design

Stable JSON envelope, machine-readable error taxonomy, separated stdout/stderr, UUID tracking.

Raw API Passthrough

qualtrics raw for immediate authenticated access to any endpoint.

Quick Start

bash

# Install
brew tap thedavidweng/tap
brew install --cask qualtrics

# Set up credentials
qualtrics auth set-token
qualtrics auth set-datacenter pdx1
qualtrics auth status

# Compile survey offline (No API required)
qualtrics definitions build survey.md -o survey.qsf

# Manage surveys & export responses
qualtrics surveys list --json
qualtrics responses export start SV_123456789 --format csv --wait --extract

Key Commands

Command	Description
`qualtrics definitions build`	Compile Markdown survey spec to `.qsf`
`qualtrics definitions qsf summary`	Inspect and summarize `.qsf` files
`qualtrics surveys list`	List available surveys
`qualtrics definitions show`	Inspect survey definition documents
`qualtrics responses export start`	Export survey responses asynchronously
`qualtrics distributions create`	Create survey distributions
`qualtrics raw`	Authenticated passthrough for any endpoint