Tutorials

Tutorials

Guided paths that take you from zero to a useful isplay investigation.

Tutorials are for learning by doing. They use concrete commands and small examples rather than covering every option.

First captured run

Start the stack, create a project, capture one run, and inspect the evidence.

Replay a counterfactual

Create a branch, add an intervention, run replay, and read diffs and metrics.

Run a hypothesis batch

Turn several hypotheses into an experiment and inspect requirements, statistics, and effects.

Mastra claims demo

Run the bundled example and use it as a complete reference investigation.

Agent-led analysis

Install the isplay-analysis skill and let an analyst agent drive the workflow.

Before You Start

Run the quickstart once:

npm install
npx isplay start
export ISPLAY_API_URL=http://127.0.0.1:7373
npx isplay projects create --name "Tutorial Lab"
export ISPLAY_PROJECT_ID="<id>"

When a tutorial asks for IDs, use the JSON returned by the previous command. Do not invent IDs.

Quickstart

Run the local stack, capture a tool-backed execution, replay a branch, and inspect bounded evidence.

First Captured Run

Capture a small SDK-backed run and inspect the resulting run, events, context, and checkpoints.