From 35e5c1d954e5ea25459dd2bb59c279a568a94958 Mon Sep 17 00:00:00 2001 From: Sam & Claude Date: Sat, 20 Jun 2026 08:24:18 +0200 Subject: [PATCH] fix(xfce): replace noisy autostart with start-here note (Sam & Codex) --- build.sh | 17 +++- live/operator-session/START-HERE.txt | 84 +++++++++++++++++++ live/operator-session/bootstrap.html | 11 +-- .../clawdie-bootstrap-launch.sh | 42 +++------- .../clawdie-bootstrap.desktop | 7 +- .../colibri-dashboard.desktop | 9 ++ 6 files changed, 128 insertions(+), 42 deletions(-) create mode 100644 live/operator-session/START-HERE.txt create mode 100644 live/operator-session/colibri-dashboard.desktop diff --git a/build.sh b/build.sh index 7fef5743..1c87eccb 100755 --- a/build.sh +++ b/build.sh @@ -1591,17 +1591,27 @@ EOF mkdir -p "${MOUNT_POINT}/usr/local/share/applications" install -m 0644 "${LIVE_SESSION_DIR}/clawdie-bootstrap.desktop" \ - "${MOUNT_POINT}/usr/local/share/applications/Clawdie Bootstrap.desktop" + "${MOUNT_POINT}/usr/local/share/applications/Clawdie Start Here.desktop" + install -m 0644 "${LIVE_SESSION_DIR}/colibri-dashboard.desktop" \ + "${MOUNT_POINT}/usr/local/share/applications/Colibri Dashboard.desktop" install -m 0644 "${LIVE_SESSION_DIR}/hw-report.desktop" \ "${MOUNT_POINT}/usr/local/share/applications/Clawdie Hardware Report.desktop" mkdir -p "${MOUNT_POINT}/home/clawdie/Desktop" install -m 0644 "${LIVE_SESSION_DIR}/clawdie-bootstrap.desktop" \ - "${MOUNT_POINT}/home/clawdie/Desktop/Clawdie Bootstrap.desktop" + "${MOUNT_POINT}/home/clawdie/Desktop/Clawdie Start Here.desktop" + install -m 0644 "${LIVE_SESSION_DIR}/colibri-dashboard.desktop" \ + "${MOUNT_POINT}/home/clawdie/Desktop/Colibri Dashboard.desktop" install -m 0644 "${LIVE_SESSION_DIR}/hw-report.desktop" \ "${MOUNT_POINT}/home/clawdie/Desktop/Clawdie Hardware Report.desktop" + mkdir -p "${MOUNT_POINT}/usr/local/share/clawdie-iso" + install -m 0644 "${LIVE_SESSION_DIR}/START-HERE.txt" \ + "${MOUNT_POINT}/usr/local/share/clawdie-iso/START-HERE.txt" mkdir -p "${MOUNT_POINT}/usr/local/share/clawdie-iso/bootstrap" install -m 0644 "${LIVE_SESSION_DIR}/bootstrap.html" \ "${MOUNT_POINT}/usr/local/share/clawdie-iso/bootstrap/index.html" + mkdir -p "${MOUNT_POINT}/usr/local/share/clawdie-iso/seed" + install -m 0644 "${LIVE_SESSION_DIR}/clawdie-live-seed.README.txt" \ + "${MOUNT_POINT}/usr/local/share/clawdie-iso/seed/README.txt" if [ -d "${LIVE_SESSION_DIR}/mcp-examples" ]; then mkdir -p "${MOUNT_POINT}/usr/local/share/clawdie-iso/mcp-examples" cp -R "${LIVE_SESSION_DIR}/mcp-examples/." \ @@ -1612,7 +1622,8 @@ EOF chroot "$MOUNT_POINT" chown -R clawdie:clawdie /home/clawdie/Desktop chmod 0755 "${MOUNT_POINT}/home/clawdie/Desktop" chmod 0644 \ - "${MOUNT_POINT}/home/clawdie/Desktop/Clawdie Bootstrap.desktop" \ + "${MOUNT_POINT}/home/clawdie/Desktop/Clawdie Start Here.desktop" \ + "${MOUNT_POINT}/home/clawdie/Desktop/Colibri Dashboard.desktop" \ "${MOUNT_POINT}/home/clawdie/Desktop/Clawdie Hardware Report.desktop" install_live_ai_source_snapshots diff --git a/live/operator-session/START-HERE.txt b/live/operator-session/START-HERE.txt new file mode 100644 index 00000000..da9fe937 --- /dev/null +++ b/live/operator-session/START-HERE.txt @@ -0,0 +1,84 @@ +CLAWDIE OPERATOR USB — START HERE +================================= + +This desktop opens quiet on purpose. +Colibri runs in the background; you choose when to open the operator UI. + +FIRST ACTIONS +------------- + +1. Save any notes you want in this file or close it. +2. Open "Colibri Dashboard" on the desktop when you are ready. +3. Use "Clawdie Hardware Report" if this machine needs diagnostics. + +COLIBRI +------- + +The daemon should already be running. + +Check: + service colibri_daemon status + +If needed: + mdo -u root service colibri_daemon start + +Desktop launcher: + Colibri Dashboard + +Terminal commands: + colibri status + colibri snapshot + colibri list-tasks + colibri list-skills + colibri-mcp tools + +SECRETS / PROVIDERS +------------------- + +Provider env: + /usr/local/etc/colibri/provider.env + +If you are using Vaultwarden bootstrap: + - the image already knows the Clawdie Vaultwarden URL + - add BW_CLIENTID, BW_CLIENTSECRET, and BW_PASSWORD + - keep the file mode 0600 + - restart colibri_daemon after edits + +Example: + mdo -u root ee /usr/local/etc/colibri/provider.env + mdo -u root chmod 600 /usr/local/etc/colibri/provider.env + mdo -u root service colibri_daemon restart + +LIVE SEED +--------- + +Seed partition label: + CLAWDIESEED + +Readable operator guide: + /usr/local/share/clawdie-iso/seed/README.txt + +REFERENCE +--------- + +Full HTML reference: + /usr/local/share/clawdie-iso/bootstrap/index.html + +Open manually: + firefox file:///usr/local/share/clawdie-iso/bootstrap/index.html + +HARDWARE REPORT +--------------- + +Desktop launcher: + Clawdie Hardware Report + +Terminal: + mdo -u root hw-report + +PRIVILEGE MODEL +--------------- + +This USB does not use sudo. +Use: + mdo -u root diff --git a/live/operator-session/bootstrap.html b/live/operator-session/bootstrap.html index 09d9d516..d3bc5f4f 100644 --- a/live/operator-session/bootstrap.html +++ b/live/operator-session/bootstrap.html @@ -79,8 +79,9 @@

Clawdie Operator USB

Live USB workstation for the Clawdie operator. Colibri daemon manages - agent supervision, skills, and tasks. The TUI dashboard is your primary - monitor — this page is for reference and quick checks. + agent supervision, skills, and tasks. This HTML page is deeper + reference; the desktop now opens with a short START-HERE note in + Mousepad and leaves the dashboard/browser as explicit operator choices.

@@ -96,14 +97,14 @@
  • pi coding agent harness (npm global)
  • DeepSeek prefix caching (~3,500 free tokens per request)
  • FreeBSD mac_do for kernel-enforced privilege escalation
    • -
  • Python 3.11 with python + python3 symlinks
    • +
  • Python 3.12 with python + python3 symlinks

    • Primary dashboard

    - The colibri-tui dashboard opens automatically in a terminal - window at login. If closed, restart with: + The colibri-tui dashboard is launched explicitly from the + desktop or terminal. If closed, restart with: 

    colibri-tui
    diff --git a/live/operator-session/clawdie-bootstrap-launch.sh b/live/operator-session/clawdie-bootstrap-launch.sh index 7353ec74..1324591b 100644 --- a/live/operator-session/clawdie-bootstrap-launch.sh +++ b/live/operator-session/clawdie-bootstrap-launch.sh @@ -1,15 +1,13 @@ #!/bin/sh # Clawdie Operator USB — session bootstrap # -# 1. Launch colibri-tui in xfce4-terminal (primary operator dashboard). -# 2. Open the bootstrap docs page in Firefox (reference / quick checks). -# -# The TUI gives live agent supervision (states, sessions, spawn/kill). -# Firefox remains available for docs, browsing, and Tailscale admin. +# Open one calm starting surface on login: a local START-HERE note in Mousepad. +# Operators can then save notes/edits and explicitly launch Colibri, hw-report, +# or the deeper HTML reference from the desktop. set -eu -PAGE="${1:-/usr/local/share/clawdie-iso/bootstrap/index.html}" +PAGE="${1:-/usr/local/share/clawdie-iso/START-HERE.txt}" LOG_DIR="${XDG_CACHE_HOME:-${HOME}/.cache}/clawdie" LOG_FILE="${LOG_FILE:-${LOG_DIR}/bootstrap.log}" @@ -20,33 +18,17 @@ log_msg() { mkdir -p "$(dirname "$LOG_FILE")" touch "$LOG_FILE" 2>/dev/null || LOG_FILE=/dev/null -# 1. Launch colibri-tui in a dedicated terminal window. -TUI_BIN="/usr/local/bin/colibri-tui" -TERM_BIN="/usr/local/bin/xfce4-terminal" - -if [ -x "$TUI_BIN" ]; then - if [ -x "$TERM_BIN" ]; then - log_msg "Launching colibri-tui in xfce4-terminal" - "$TERM_BIN" \ - --title="Colibri Dashboard" \ - --geometry=120x30 \ - --command="$TUI_BIN" \ - >> "$LOG_FILE" 2>&1 & - else - log_msg "xfce4-terminal not found, colibri-tui requires a terminal" - fi -else - log_msg "colibri-tui not found — skipping TUI dashboard" +if [ ! -f "$PAGE" ]; then + log_msg "Start note missing: $PAGE" + exit 1 fi -# 2. Open the bootstrap reference page in Firefox. -URL="file://${PAGE}" -for browser in /usr/local/bin/firefox /usr/local/bin/xdg-open; do - if [ -x "$browser" ]; then - log_msg "Launching ${browser} ${URL}" - exec "$browser" "$URL" >> "$LOG_FILE" 2>&1 +for editor in /usr/local/bin/mousepad /usr/local/bin/xdg-open; do + if [ -x "$editor" ]; then + log_msg "Launching ${editor} ${PAGE}" + exec "$editor" "$PAGE" >> "$LOG_FILE" 2>&1 fi done -log_msg "No supported browser found for ${URL}" +log_msg "No supported editor found for ${PAGE}" exit 1 diff --git a/live/operator-session/clawdie-bootstrap.desktop b/live/operator-session/clawdie-bootstrap.desktop index fa88248b..8d48753a 100644 --- a/live/operator-session/clawdie-bootstrap.desktop +++ b/live/operator-session/clawdie-bootstrap.desktop @@ -1,10 +1,9 @@ [Desktop Entry] Type=Application Version=1.0 -Name=Clawdie Bootstrap -Comment=Open the Clawdie operator bootstrap page +Name=Clawdie Start Here +Comment=Open the operator start note in Mousepad Exec=/usr/local/bin/clawdie-bootstrap-launch.sh -Icon=web-browser +Icon=accessories-text-editor Terminal=false Categories=System;Utility; - diff --git a/live/operator-session/colibri-dashboard.desktop b/live/operator-session/colibri-dashboard.desktop new file mode 100644 index 00000000..fc0277b8 --- /dev/null +++ b/live/operator-session/colibri-dashboard.desktop @@ -0,0 +1,9 @@ +[Desktop Entry] +Type=Application +Version=1.0 +Name=Colibri Dashboard +Comment=Open the live Colibri operator dashboard in a terminal +Exec=xfce4-terminal --title "Colibri Dashboard" --geometry=120x30 --command "/usr/local/bin/colibri-tui" +Icon=utilities-terminal +Terminal=false +Categories=System;Utility; -- 2.45.3