Reshape the agent launcher into omarchy agent (#6757)

* Reshape the agent launcher into omarchy agent omarchy-launch-agent becomes omarchy-agent, with prompts on omarchy-agent-prompt rather than the bare route: `omarchy agent` is both a command and a group, so a positional prompt there would shadow any subcommand under it. The launcher takes flags only and points at `omarchy agent prompt` when handed one. Every agent window now launches under a fixed org.omarchy.agent app-id instead of omarchy-launch-tui's default of org.omarchy.<binary>, so one rule floats them all whichever agent is default. Omarchy also stops picking an agent for you. omarchy-default-agent prints nothing until one is chosen, leaving every entry under Setup > Defaults > Agent unchecked, and a first-run invitation offers to take you there. * Wordsmith * Cover the agent routes and the invitation The route split is the point of the change, so exercise `omarchy agent`, `omarchy agent prompt`, and a rejected positional prompt through the router rather than only the binaries behind them. The invitation gets the same treatment as the Voxtype and fingerprint ones: it notifies once, opens the agent defaults menu, and leaves both the notification and the marker alone for anyone who already chose an agent. * Offer the agent choice from the keybinding Super + Shift + Ctrl + A now runs `omarchy-agent --pick`, which opens Setup > Defaults > Agent when nothing is chosen yet. A keypress that writes to stderr and opens nothing just looks broken. * Reach existing installs with the agent invitation first-run installs the invitation hook, and existing accounts marked it complete long ago, so they would never see it -- while being the accounts most likely to need it, since the old getter returned opencode implicitly and most have no agent recorded at all. Post-update hooks run later in the same update, so the invitation arrives without waiting for another one. * Say what the Defaults submenus set Setup > Defaults lists Agent, Browser, Terminal, Editor, but the header inside each repeated the same bare word, which reads as a category rather than a setting -- and says nothing at all when the menu is summoned straight into it. The list keeps its short labels; the headers now name the setting.
2026-08-12 17:56:19 +02:00
parent b97a1480dc
commit 9502b81f3b
12 changed files with 240 additions and 45 deletions
@@ -0,0 +1,61 @@
+#!/bin/bash
+
+source "$(dirname "$0")/base-test.sh"
+
+test_home=$(mktemp -d)
+test_bin=$(mktemp -d)
+log_file=$(mktemp)
+hook_path="$test_home/.config/omarchy/hooks/post-update.d/setup-agent.hook"
+
+cleanup() {
+  rm -rf "$test_home" "$test_bin"
+  rm -f "$log_file"
+}
+trap cleanup EXIT
+
+mkdir -p "$(dirname "$hook_path")"
+
+cat >"$test_bin/omarchy-notification-send" <<'EOF'
+#!/bin/bash
+echo notification >>"$TEST_LOG"
+while (($# > 0)); do
+  [[ $1 == "--exec" ]] && echo "exec:$2" >>"$TEST_LOG"
+  shift
+done
+EOF
+chmod +x "$test_bin/omarchy-notification-send"
+
+run_invitation_hook() {
+  cp "$ROOT/install/user/first-run/setup-agent.hook" "$hook_path"
+  HOME="$test_home" PATH="$test_bin:$ROOT/bin:$PATH" TEST_LOG="$log_file" bash "$hook_path"
+}
+
+run_invitation_hook
+
+[[ -f $test_home/.local/state/omarchy/done/agent-setup-invitation ]] || fail "agent invitation records completion"
+[[ -f $hook_path ]] || fail "agent invitation keeps its hook installed"
+[[ $(grep -c '^notification$' "$log_file") -eq 1 ]] || fail "agent invitation sends one notification"
+grep -qx 'exec:omarchy menu summon setup.default.agent' "$log_file" ||
+  fail "agent invitation opens the agent defaults menu"
+
+run_invitation_hook
+[[ $(grep -c '^notification$' "$log_file") -eq 1 ]] || fail "completed agent invitation does not notify again"
+
+pass "agent invitation only runs once"
+
+# Someone who already chose an agent has nothing to be invited to, and must not
+# burn the marker either -- otherwise clearing the choice later leaves them with
+# no invitation and no default.
+fresh_home=$(mktemp -d)
+mkdir -p "$fresh_home/.config/omarchy/defaults"
+printf 'claude\n' >"$fresh_home/.config/omarchy/defaults/agent"
+: >"$log_file"
+cp "$ROOT/install/user/first-run/setup-agent.hook" "$hook_path"
+HOME="$fresh_home" PATH="$test_bin:$ROOT/bin:$PATH" TEST_LOG="$log_file" bash "$hook_path"
+
+[[ ! -s $log_file ]] || fail "agent invitation stays quiet when a default is already set"
+[[ ! -f $fresh_home/.local/state/omarchy/done/agent-setup-invitation ]] ||
+  fail "agent invitation leaves its marker unset when a default is already set"
+rm -rf "$fresh_home"
+
+pass "agent invitation skips anyone who already chose an agent"