From 5cd93f688aaab89dbb6dfa4aca535f21796ae185 Mon Sep 17 00:00:00 2001
From: Armin Ronacher <armin.ronacher@active-4.com>
Date: Thu, 20 Aug 2026 15:59:12 +0200
Subject: [PATCH] feat(coding-agent): add development pi wrapper

---
 scripts/auto-pi.sh | 75 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 75 insertions(+)
 create mode 100755 scripts/auto-pi.sh

diff --git a/scripts/auto-pi.sh b/scripts/auto-pi.sh
new file mode 100755
index 000000000..2cab40be1
--- /dev/null
+++ b/scripts/auto-pi.sh
@@ -0,0 +1,75 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Developer wrapper that runs pi from this checkout's latest `npm run build`.
+# Development invocations use PI_EXPERIMENTAL=1 by default. Pass --stable to use
+# the next pi executable on PATH; `pi update` also uses stable so self-update
+# works.
+#
+# From the repository root, install with:
+#   mkdir -p "$HOME/.local/bin"
+#   ln -s "$PWD/scripts/auto-pi.sh" "$HOME/.local/bin/pi"
+#
+# ~/.local/bin must appear before the stable pi installation on PATH.
+
+# Resolve this script through symlinks so repo_dir points at the development
+# checkout rather than the directory containing the `pi` symlink.
+script_path="${BASH_SOURCE[0]}"
+while [[ -L "$script_path" ]]; do
+	script_dir="$(cd -P "$(dirname "$script_path")" && pwd)"
+	link_target="$(readlink "$script_path")"
+	if [[ "$link_target" == /* ]]; then
+		script_path="$link_target"
+	else
+		script_path="$script_dir/$link_target"
+	fi
+done
+script_dir="$(cd -P "$(dirname "$script_path")" && pwd)"
+repo_dir="$(cd "$script_dir/.." && pwd)"
+
+find_stable_pi() {
+	local path_entry candidate candidate_dir
+	local -a path_entries
+	IFS=: read -r -a path_entries <<< "${PATH:-}"
+	for path_entry in "${path_entries[@]}"; do
+		[[ -n "$path_entry" ]] || path_entry=.
+		candidate="$path_entry/pi"
+		[[ -x "$candidate" && ! -d "$candidate" ]] || continue
+		[[ "$candidate" -ef "$script_path" ]] && continue
+		candidate_dir="$(cd -P "$(dirname "$candidate")" && pwd)" || continue
+		printf '%s/%s\n' "$candidate_dir" "$(basename "$candidate")"
+		return 0
+	done
+	return 1
+}
+
+use_stable=false
+args=()
+for arg in "$@"; do
+	if [[ "$arg" == "--stable" ]]; then
+		use_stable=true
+	else
+		args+=("$arg")
+	fi
+done
+
+if [[ "${args[0]:-}" == "update" ]]; then
+	use_stable=true
+fi
+
+if [[ "$use_stable" == true ]]; then
+	if ! stable_pi="$(find_stable_pi)"; then
+		echo "error: could not find a stable pi executable after the auto-pi wrapper on PATH" >&2
+		exit 1
+	fi
+	exec "$stable_pi" ${args[@]+"${args[@]}"}
+fi
+
+dev_pi="$repo_dir/packages/coding-agent/dist/cli.js"
+if [[ ! -x "$dev_pi" ]]; then
+	echo "error: development pi build not found; run \`npm run build\` in $repo_dir" >&2
+	exit 1
+fi
+
+export PI_EXPERIMENTAL="${PI_EXPERIMENTAL:-1}"
+exec "$dev_pi" ${args[@]+"${args[@]}"}