Quester Studio

Getting started

Run and validate flows with the Quester CLI

Prefer a downloadable desktop build? See Try Quester Studio, Download, or the Guide.

Install (from source)

bun install
bun run build

Or install from npm (v0.4.0+):

bunx @quester-studio/cli --help

Scaffold a workspace

bunx --bun quester init ./my-workspace
bunx --bun quester validate ./my-workspace

Creates quester.json, flows/hello.flow.json (start → input), environments/local.json, a secrets example, and .gitignore for *.secrets.json and runs/.

Validate a workspace

bunx quester validate examples/sample-workspace

Run a scenario

Start with the hero auth chain:

bunx quester run examples/sample-workspace/flows/login-and-profile.flow.json \
  --workspace examples/sample-workspace \
  --env local \
  --input '{"username":"emilys","password":"emilyspass"}'

Short pedagogical sample:

bunx quester run examples/sample-workspace/flows/demo-main-nodes.flow.json \
  --workspace examples/sample-workspace \
  --env local

Longer walkthrough that hits every builtin (including delay, switch, try, foreach, subflow, log, inspect, and a disconnected note) and most HTTP methods:

bunx quester run examples/sample-workspace/flows/kitchen-sink.flow.json \
  --workspace examples/sample-workspace \
  --env local \
  --input '{"username":"emilys","password":"emilyspass","productTitle":"Quester Pencil","searchQuery":"phone"}'

Run logs and reports

bunx quester run login-and-profile \
  --workspace examples/sample-workspace \
  --env local \
  --runs-dir runs \
  --report report.json

See Run logs on disk and Suites.

Continuous integration

Offline-safe validation in GitHub Actions:

- name: Validate sample workspace
  run: bunx --bun quester validate examples/sample-workspace

Optional suite (needs network for DummyJSON):

- name: Smoke suite
  run: bunx --bun quester suite smoke --workspace examples/sample-workspace --report suite-report.json
  continue-on-error: true
- uses: actions/upload-artifact@v4
  if: always()
  with:
    name: quester-runs
    path: examples/sample-workspace/runs/
    if-no-files-found: ignore

Learn more