scripts/hitl-loop.template.sh

skills/engineering/diagnosing-bugs/scripts/hitl-loop.template.sh · 1.3 KB · View on GitHub at 4ae2317

What it does. A Bash template for a human-in-the-loop reproduction loop. It defines two helpers: step prints an instruction and waits for Enter, and capture prints a question and reads the answer into a variable. Between “edit below” and “edit above” markers it has example steps (open the app at localhost:3000, click Export, record whether it threw and the error message), and at the end it prints every captured value as KEY=VALUE for the agent to read.

Why it’s here. It is the last of the ten ways to build a feedback loop in Phase 1: “If a human must click, drive them with scripts/hitl-loop.template.sh so the loop is still structured.” The Phase 1 completion checklist also allows a human in the loop “only via scripts/hitl-loop.template.sh”.

#!/usr/bin/env bash
# Human-in-the-loop reproduction loop.
# Copy this file, edit the steps below, and run it.
# The agent runs the script; the user follows prompts in their terminal.
#
# Usage:
#   bash hitl-loop.template.sh
#
# Two helpers:
#   step "<instruction>"          → show instruction, wait for Enter
#   capture VAR "<question>"      → show question, read response into VAR
#
# At the end, captured values are printed as KEY=VALUE for the agent to parse.
#
# `capture` prints its value back to the terminal, where the agent reads it,
# so capture observations, and leave signing in to the user as a `step`.

set -euo pipefail

step() {
  printf '\n>>> %s\n' "$1"
  read -r -p "    [Enter when done] " _
}

capture() {
  local var="$1" question="$2" answer
  printf '\n>>> %s\n' "$question"
  read -r -p "    > " answer
  printf -v "$var" '%s' "$answer"
}

# --- edit below ---------------------------------------------------------

step "Open the app at http://localhost:3000 and sign in."

capture ERRORED "Click the 'Export' button. Did it throw an error? (y/n)"

capture ERROR_MSG "Paste the error message (or 'none'):"

# --- edit above ---------------------------------------------------------

printf '\n--- Captured ---\n'
printf 'ERRORED=%s\n' "$ERRORED"
printf 'ERROR_MSG=%s\n' "$ERROR_MSG"