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

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 <command>

live/operator-session/bootstrap.html

@@ -79,8 +79,9 @@
       <h1>Clawdie Operator USB</h1>
       <p class="lead">
         Live USB workstation for the Clawdie operator. Colibri daemon manages
-        agent supervision, skills, and tasks. The TUI dashboard is your primary
+        agent supervision, skills, and tasks. This HTML page is deeper
-        monitor — this page is for reference and quick checks.
+        reference; the desktop now opens with a short START-HERE note in
+        Mousepad and leaves the dashboard/browser as explicit operator choices.
       </p>
 
       <div class="card">
@@ -96,14 +97,14 @@
           <li><code>pi</code> coding agent harness (npm global)</li>
           <li>DeepSeek prefix caching (~3,500 free tokens per request)</li>
           <li>FreeBSD <code>mac_do</code> for kernel-enforced privilege escalation</li>
-          <li>Python 3.11 with <code>python</code> + <code>python3</code> symlinks</li>
+          <li>Python 3.12 with <code>python</code> + <code>python3</code> symlinks</li>
         </ul>
       </div>
 
       <h2>Primary dashboard</h2>
       <p>
-        The <code>colibri-tui</code> dashboard opens automatically in a terminal
+        The <code>colibri-tui</code> dashboard is launched explicitly from the
-        window at login. If closed, restart with:
+        desktop or terminal. If closed, restart with:
       </p>
       <pre>colibri-tui</pre>
 

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).
+# Open one calm starting surface on login: a local START-HERE note in Mousepad.
-# 2. Open the bootstrap docs page in Firefox (reference / quick checks).
+# Operators can then save notes/edits and explicitly launch Colibri, hw-report,
-#
+# or the deeper HTML reference from the desktop.
-# The TUI gives live agent supervision (states, sessions, spawn/kill).
-# Firefox remains available for docs, browsing, and Tailscale admin.
 
 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.
+if [ ! -f "$PAGE" ]; then
-TUI_BIN="/usr/local/bin/colibri-tui"
+    log_msg "Start note missing: $PAGE"
-TERM_BIN="/usr/local/bin/xfce4-terminal"
+    exit 1
-
-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"
 fi
 
-# 2. Open the bootstrap reference page in Firefox.
+for editor in /usr/local/bin/mousepad /usr/local/bin/xdg-open; do
-URL="file://${PAGE}"
+    if [ -x "$editor" ]; then
-for browser in /usr/local/bin/firefox /usr/local/bin/xdg-open; do
+        log_msg "Launching ${editor} ${PAGE}"
-    if [ -x "$browser" ]; then
+        exec "$editor" "$PAGE" >> "$LOG_FILE" 2>&1
-        log_msg "Launching ${browser} ${URL}"
-        exec "$browser" "$URL" >> "$LOG_FILE" 2>&1
     fi
 done
 
-log_msg "No supported browser found for ${URL}"
+log_msg "No supported editor found for ${PAGE}"
 exit 1

live/operator-session/clawdie-bootstrap.desktop

@@ -1,10 +1,9 @@
 [Desktop Entry]
 Type=Application
 Version=1.0
-Name=Clawdie Bootstrap
+Name=Clawdie Start Here
-Comment=Open the Clawdie operator bootstrap page
+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;
-

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;