LaufwerkLaufwerk

Use Studio

Start workflows, inspect results and respond when a run needs you.

Studio is the local interface for the workflows in your repository. Start it from the repository root:

bunx laufwerk@0.0.1-alpha.13 studio

Open the URL printed in the terminal. Runs started through the CLI or your coding agent appear here too.

Start and inspect a run

Click Start run, choose a workflow, enter its input as JSON, then click Start workflow. If you're trying this for the first time, use Hello World.

Select a run to inspect its status and run history. Workflows with agent sessions and activities also show their recorded execution, logs and session details. Hello World only returns a greeting, so it has no agent transcript or multi-step execution to inspect. Studio currently does not show its top-level return value; use the JSON command in getting started to read it.

Respond and control

Studio shows controls when they apply to the run:

What you needWhat to do
Answer a workflow's question or approval requestOpen the pending interaction in the run or Inbox and respond.
Stop a runUse Cancel when available. Cancellation does not undo work already done.
Continue an interrupted runInspect its state first, then use the available resume or recovery controls.
Try changed workflow codeStart with a new execution key. Existing runs retain their original workflow bundle.

Hello World finishes immediately and asks no questions. To try a pause for your input, see human decisions. For a failed or interrupted run, follow inspect and debug.

Where runs live

Workflow code and configuration live in your repository's laufwerk/ folder. Run state is stored separately under ~/.laufwerk/state by default. Keep laufwerk/project.json: its project identity connects the repository to its recorded runs.

Next: build a workflow →

On this page