- luxe starts on the model you last chose in this project, then the last one anywhere. Signing in opens the model picker instead of choosing for you. - Every list in a modal takes the mouse wheel and a draggable scrollbar. - The phone app shows reasoning in full, stays put while you read back through a long session, and shows a question's answer on its card. - On Windows, luxe update replaces the running luxe, and a signed-in install no longer sees setup again. - The file tree no longer shows "engine busy" in a large project, loop output is easier to follow, and the name is written lowercase. The CHANGELOG has the full list.
287 lines
8.4 KiB
Bash
Executable File
287 lines
8.4 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# Drive the TUI through a scripted sequence and capture screenshots along the way.
|
|
#
|
|
# The agent-loop `screenshot` tool launches a command, waits, types every key at once and shoots
|
|
# immediately — which is useless for anything with latency (a review capture, a provider round-trip)
|
|
# or for stepping a surface. This drives a real terminal with explicit pauses between steps, so what
|
|
# lands in the image is the state you meant to look at.
|
|
#
|
|
# Usage:
|
|
# scripts/tui-drive.sh [options] -- <script-file>
|
|
# scripts/tui-drive.sh [options] -s 'step; step; …'
|
|
#
|
|
# Options:
|
|
# --cols N terminal columns (default 170)
|
|
# --rows N terminal rows (default 48)
|
|
# --theme NAME LUXE theme override written to the throwaway config
|
|
# --out DIR screenshot directory (default .pi/agent-loop/shots)
|
|
# --cmd 'CMDLINE' what to run in the terminal (default: target/release/luxe)
|
|
# --keep leave the terminal open when the script ends
|
|
# -s 'STEPS' inline steps, separated by `;` or newlines
|
|
#
|
|
# Steps (one per line, `#` comments allowed):
|
|
# sleep <seconds> wait (fractions fine)
|
|
# type <text> type literal text (no Enter)
|
|
# enter <text> type text then press Return
|
|
# key <keysym>[ xN] press a key by xkb name (Return, Escape, Tab, Down, F5, …), N times
|
|
# mod <mods> <keysym> press a chord, mods among ctrl/alt/shift/logo joined by `+`
|
|
# shot <name> capture the window to <out>/<name>.png (+ a downscaled .jpg)
|
|
# log <text> echo a progress note
|
|
#
|
|
# Environment passed through to the app: anything already exported, plus LUXE_* set by the caller.
|
|
# A throwaway XDG_CONFIG_HOME is built from your real ~/.config/luxe with the startup dashboard
|
|
# disabled, so the first keystroke always reaches the composer instead of a splash screen.
|
|
|
|
set -euo pipefail
|
|
|
|
repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
|
cols=170
|
|
rows=48
|
|
theme=""
|
|
out_dir="${repo_root}/.pi/agent-loop/shots"
|
|
app_cmd="${repo_root}/target/release/luxe"
|
|
keep=false
|
|
inline_steps=""
|
|
script_file=""
|
|
|
|
usage() { sed -n '2,33p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'; }
|
|
|
|
while [[ $# -gt 0 ]]; do
|
|
case "$1" in
|
|
--cols)
|
|
cols="$2"
|
|
shift 2
|
|
;;
|
|
--rows)
|
|
rows="$2"
|
|
shift 2
|
|
;;
|
|
--theme)
|
|
theme="$2"
|
|
shift 2
|
|
;;
|
|
--out)
|
|
out_dir="$2"
|
|
shift 2
|
|
;;
|
|
--cmd)
|
|
app_cmd="$2"
|
|
shift 2
|
|
;;
|
|
--keep)
|
|
keep=true
|
|
shift
|
|
;;
|
|
-s)
|
|
inline_steps="$2"
|
|
shift 2
|
|
;;
|
|
-h | --help)
|
|
usage
|
|
exit 0
|
|
;;
|
|
--)
|
|
shift
|
|
script_file="${1:-}"
|
|
shift || true
|
|
;;
|
|
*)
|
|
script_file="$1"
|
|
shift
|
|
;;
|
|
esac
|
|
done
|
|
|
|
for tool in alacritty wtype grim hyprctl jq; do
|
|
command -v "$tool" >/dev/null || {
|
|
echo "missing required tool: $tool" >&2
|
|
exit 2
|
|
}
|
|
done
|
|
|
|
mkdir -p "$out_dir"
|
|
|
|
# A throwaway config dir mirroring the user's (keys, providers) with the dashboard off: typing has
|
|
# to land in the composer, and the splash screen swallows the first keystrokes.
|
|
config_home="$(mktemp -d /tmp/luxe-drive-XXXXXX)"
|
|
mkdir -p "${config_home}/luxe"
|
|
if [[ -d "${XDG_CONFIG_HOME:-$HOME/.config}/luxe" ]]; then
|
|
cp -r "${XDG_CONFIG_HOME:-$HOME/.config}/luxe/." "${config_home}/luxe/" 2>/dev/null || true
|
|
fi
|
|
python3 - "$config_home" "$theme" <<'PY'
|
|
import json, pathlib, sys
|
|
home, theme = sys.argv[1], sys.argv[2]
|
|
path = pathlib.Path(home) / "luxe" / "config.json"
|
|
config = {}
|
|
if path.exists():
|
|
try:
|
|
config = json.loads(path.read_text())
|
|
except Exception:
|
|
config = {}
|
|
config["dashboard"] = False
|
|
config["notifications"] = False
|
|
if theme:
|
|
config["theme"] = theme
|
|
path.write_text(json.dumps(config, indent=2))
|
|
PY
|
|
|
|
title="luxe-drive-$$"
|
|
window_class="luxe-drive"
|
|
font_size="${LUXE_DRIVE_FONT_SIZE:-11}"
|
|
|
|
# Hyprland 0.56 moved `dispatch` and the config parser to Lua, so the legacy spellings below now
|
|
# fail — and under `set -e` a failed `hyprctl` took the whole drive down before a single step ran.
|
|
# Both forms are tried, and neither is fatal: the worst case is a tiled window whose grid the tile
|
|
# decided, which `refresh_geometry` reads back anyway.
|
|
hypr() {
|
|
hyprctl dispatch "$1" >/dev/null 2>&1 && return 0
|
|
hyprctl dispatch "$2" >/dev/null 2>&1 && return 0
|
|
return 0
|
|
}
|
|
|
|
# Float the terminal so the compositor honors the geometry alacritty asks for; tiled, the tile
|
|
# decides the grid and `--cols/--rows` become suggestions (a 170x48 request rendered 230x74).
|
|
hyprctl keyword windowrulev2 "float, class:^(${window_class})\$" >/dev/null 2>&1 || true
|
|
|
|
cleanup() {
|
|
if [[ "$keep" == false && -n "${term_pid:-}" ]]; then
|
|
kill "$term_pid" 2>/dev/null || true
|
|
fi
|
|
rm -rf "$config_home"
|
|
}
|
|
trap cleanup EXIT
|
|
|
|
# The throwaway XDG_CONFIG_HOME is for luxe alone. gh finds its hosts.yml under the same variable,
|
|
# so without this every GitHub surface in the drive reads "not signed in" while gh is fine
|
|
export GH_CONFIG_DIR="${GH_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/gh}"
|
|
|
|
XDG_CONFIG_HOME="$config_home" alacritty \
|
|
--class "$window_class,$window_class" \
|
|
--title "$title" \
|
|
-o "window.dimensions.columns=$cols" \
|
|
-o "window.dimensions.lines=$rows" \
|
|
-o "font.size=$font_size" \
|
|
-e bash -lc "cd '$repo_root' && $app_cmd" &
|
|
term_pid=$!
|
|
|
|
# Wait for the window to map before typing at it.
|
|
geometry=""
|
|
for _ in $(seq 1 60); do
|
|
geometry="$(hyprctl clients -j | jq -r --arg t "$title" '.[] | select(.title==$t) | "\(.at[0]),\(.at[1]) \(.size[0])x\(.size[1])"' | head -1)"
|
|
[[ -n "$geometry" ]] && break
|
|
sleep 0.2
|
|
done
|
|
if [[ -z "$geometry" ]]; then
|
|
echo "terminal window '$title' never appeared" >&2
|
|
exit 1
|
|
fi
|
|
# Focus it so keystrokes land here and not in whatever had focus.
|
|
hypr "hl.dsp.focus({ window = \"title:$title\" })" "focuswindow title:$title"
|
|
|
|
refresh_geometry() {
|
|
geometry="$(hyprctl clients -j | jq -r --arg t "$title" '.[] | select(.title==$t) | "\(.at[0]),\(.at[1]) \(.size[0])x\(.size[1])"' | head -1)"
|
|
}
|
|
|
|
# Wait without going idle.
|
|
#
|
|
# A drive is mostly waiting on a provider, which to the compositor looks like nobody is at the
|
|
# keyboard — long enough and the screensaver/lock takes the screen, the captures become pictures of
|
|
# hyprlock, and every subsequent scripted keystroke is typed into a password field. So long waits
|
|
# are broken up and punctuated with a bare modifier press: real input to the compositor, a no-op to
|
|
# the app under test.
|
|
idle_safe_sleep() {
|
|
local remaining="$1" chunk
|
|
while awk -v r="$remaining" 'BEGIN { exit !(r > 0) }'; do
|
|
chunk="$(awk -v r="$remaining" 'BEGIN { print (r > 30 ? 30 : r) }')"
|
|
sleep "$chunk"
|
|
remaining="$(awk -v r="$remaining" -v c="$chunk" 'BEGIN { print r - c }')"
|
|
if awk -v r="$remaining" 'BEGIN { exit !(r > 0) }'; then
|
|
wtype -M shift -m shift
|
|
fi
|
|
done
|
|
}
|
|
|
|
shot() {
|
|
local name="$1"
|
|
refresh_geometry
|
|
local png="${out_dir}/${name}.png"
|
|
# A locked or blanked screen draws no frames, and grim waits for one forever
|
|
if ! timeout 15 grim -g "$geometry" "$png"; then
|
|
echo "tui-drive: no capture within 15s; the screen is probably locked or asleep" >&2
|
|
exit 1
|
|
fi
|
|
if command -v magick >/dev/null; then
|
|
magick "$png" -resize 1280x -quality 88 "${out_dir}/${name}.jpg"
|
|
fi
|
|
echo "shot ${out_dir}/${name}.png"
|
|
}
|
|
|
|
run_step() {
|
|
local line="$1"
|
|
line="${line%%$'\r'}"
|
|
# Leading space is how an inline `-s 'a; b'` arrives, and it used to make every step after
|
|
# the first an unknown one.
|
|
line="${line#"${line%%[![:space:]]*}"}"
|
|
[[ -z "${line// /}" || "$line" == \#* ]] && return 0
|
|
local verb="${line%% *}"
|
|
local rest="${line#"$verb"}"
|
|
rest="${rest# }"
|
|
case "$verb" in
|
|
sleep) idle_safe_sleep "$rest" ;;
|
|
log) echo "-- $rest" ;;
|
|
type) wtype -- "$rest" ;;
|
|
enter)
|
|
[[ -n "$rest" ]] && wtype -- "$rest"
|
|
sleep 0.15
|
|
wtype -k Return
|
|
;;
|
|
key)
|
|
local keysym count
|
|
keysym="${rest%% *}"
|
|
count="${rest#"$keysym"}"
|
|
count="${count// /}"
|
|
[[ "$count" =~ ^x[0-9]+$ ]] && count="${count#x}" || count=1
|
|
for _ in $(seq 1 "$count"); do
|
|
wtype -k "$keysym"
|
|
sleep 0.08
|
|
done
|
|
;;
|
|
mod)
|
|
local mods keysym
|
|
mods="${rest%% *}"
|
|
keysym="${rest#"$mods"}"
|
|
keysym="${keysym# }"
|
|
local args=()
|
|
IFS='+' read -ra parts <<<"$mods"
|
|
for part in "${parts[@]}"; do args+=(-M "$part"); done
|
|
args+=(-k "$keysym")
|
|
for part in "${parts[@]}"; do args+=(-m "$part"); done
|
|
wtype "${args[@]}"
|
|
;;
|
|
shot) shot "$rest" ;;
|
|
*)
|
|
echo "unknown step: $line" >&2
|
|
return 1
|
|
;;
|
|
esac
|
|
return 0
|
|
}
|
|
|
|
steps() {
|
|
if [[ -n "$inline_steps" ]]; then
|
|
printf '%s\n' "${inline_steps//;/$'\n'}"
|
|
elif [[ -n "$script_file" ]]; then
|
|
cat "$script_file"
|
|
else
|
|
cat # stdin
|
|
fi
|
|
}
|
|
|
|
while IFS= read -r line; do
|
|
run_step "$line"
|
|
done < <(steps)
|
|
|
|
if [[ "$keep" == true ]]; then
|
|
echo "terminal left open (pid $term_pid)"
|
|
fi
|