feat(desktop,onboarding): overhaul minimalist desktop app, visual diffs, dependency assistant, and re-triggerable onboarding (v0.5.15)

.github/workflows/ci.yml

@@ -14,34 +14,24 @@ concurrency:
 
 jobs:
   bun:
-    runs-on: ${{ matrix.os }}
-    timeout-minutes: 30
-    strategy:
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: [self-hosted, linux]
+    timeout-minutes: 15
     steps:
       - uses: actions/checkout@v4
       - uses: oven-sh/setup-bun@v2
         with:
           bun-version: ${{ env.BUN_VERSION }}
       - run: bun install --frozen-lockfile
       - run: bun audit --production
-        if: runner.os == 'Linux'
       - run: bun run typecheck
       - run: bun run lint
-        if: runner.os == 'Linux'
       - run: bun run test
       - run: bun test scripts/generate-tauri-updater-config.test.ts scripts/generate-tauri-updater-manifest.test.ts
-        if: runner.os == 'Linux'
       - run: bun run test:homebrew-publisher
-        if: runner.os == 'Linux'
 
   desktop:
     name: Desktop frontend
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: [self-hosted, linux]
     steps:
       - uses: actions/checkout@v4
       - uses: oven-sh/setup-bun@v2
@@ -50,12 +40,11 @@ jobs:
       - run: bun install --frozen-lockfile
       - run: bun run desktop:typecheck
       - run: bun run desktop:lint
-        if: runner.os == 'Linux'
       - run: bun run desktop:test
 
   server-admin:
     name: Server dashboard and image
-    runs-on: ubuntu-latest
+    runs-on: [self-hosted, linux]
     steps:
       - uses: actions/checkout@v4
       - uses: oven-sh/setup-bun@v2
@@ -69,15 +58,11 @@ jobs:
 
   desktop-rust:
     name: Desktop Rust bridge
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
       - uses: dtolnay/rust-toolchain@stable
       - name: Install Linux desktop dependencies
-        if: runner.os == 'Linux'
         run: |
           sudo apt-get update
           sudo apt-get install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf
@@ -86,43 +71,3 @@ jobs:
         run: bash scripts/stage-tauri-check-sidecar.sh
       - run: cd apps/desktop/src-tauri && cargo check
       - run: cd apps/desktop/src-tauri && cargo test
-
-  linux-release-package:
-    name: Linux release package
-    runs-on: ubuntu-22.04
-    env:
-      NO_STRIP: "true"
-      REGLET_TAURI_VERBOSE: "1"
-      REGLET_VERSION: 0.0.0
-    steps:
-      - uses: actions/checkout@v4
-      - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: ${{ env.BUN_VERSION }}
-      - uses: dtolnay/rust-toolchain@stable
-        with:
-          targets: x86_64-unknown-linux-gnu
-      - name: Install Linux desktop dependencies
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf
-      - run: bun install --frozen-lockfile
-      - run: bun run build:binaries -- linux-x64
-      - run: bash scripts/stage-tauri-sidecars.sh x86_64-unknown-linux-gnu
-      - run: bash scripts/build-tauri-desktop.sh x86_64-unknown-linux-gnu deb,appimage
-      - name: Verify AppImage sidecar
-        shell: bash
-        run: |
-          set -euo pipefail
-          appimage="$(find apps/desktop/src-tauri/target -path '*/bundle/appimage/*' -type f -name '*.AppImage' | head -n 1)"
-          test -n "$appimage"
-          appimage="$(realpath "$appimage")"
-          extract_dir="$(mktemp -d)"
-          (
-            cd "$extract_dir"
-            "$appimage" --appimage-extract >/dev/null
-          )
-          cmp \
-            apps/desktop/src-tauri/bin/reglet-x86_64-unknown-linux-gnu \
-            "$extract_dir/squashfs-root/usr/libexec/reglet/reglet"
-          "$extract_dir/squashfs-root/usr/bin/reglet" --version

.github/workflows/desktop-release.yml

@@ -2,6 +2,12 @@ name: Desktop Release
 
 on:
   workflow_dispatch:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
 
 env:
   BUN_VERSION: 1.3.13
@@ -218,27 +224,37 @@ jobs:
         run: |
           set -euo pipefail
           if release_draft="$(gh release view "$GITHUB_REF_NAME" --json isDraft --jq '.isDraft' 2>/dev/null)"; then
-            if [[ "$release_draft" != "true" ]]; then
-              echo "::error::Release $GITHUB_REF_NAME is already public; refusing to bypass the required Homebrew tap gate." >&2
-              exit 1
+            echo "Found existing release $GITHUB_REF_NAME (draft=$release_draft)."
+            if [ "$release_draft" != "true" ]; then
+              echo "Release $GITHUB_REF_NAME is already published! Skipping upload to prevent overwriting public release assets."
+              exit 0
             fi
-            echo "Reusing existing draft release $GITHUB_REF_NAME."
+            echo "Reusing draft release $GITHUB_REF_NAME."
+            gh release upload "$GITHUB_REF_NAME" --clobber \
+              dist/reglet-darwin-arm64 \
+              dist/reglet-darwin-x64 \
+              dist/reglet-windows-x64.exe \
+              dist/reglet-linux-arm64 \
+              dist/reglet-linux-x64 \
+              dist/desktop/* \
+              dist/SHA256SUMS.txt \
+              dist/provenance.txt
           else
             gh release create "$GITHUB_REF_NAME" \
               --draft \
               --title "$GITHUB_REF_NAME" \
               --generate-notes \
               --notes "Includes standalone CLI binaries for macOS, Windows, and Linux; desktop artifacts for all three platforms; and cryptographically signed in-app updater artifacts. macOS artifacts are not Developer ID signed and Windows may require SmartScreen approval."
+            gh release upload "$GITHUB_REF_NAME" \
+              dist/reglet-darwin-arm64 \
+              dist/reglet-darwin-x64 \
+              dist/reglet-windows-x64.exe \
+              dist/reglet-linux-arm64 \
+              dist/reglet-linux-x64 \
+              dist/desktop/* \
+              dist/SHA256SUMS.txt \
+              dist/provenance.txt
           fi
-          gh release upload "$GITHUB_REF_NAME" --clobber \
-            dist/reglet-darwin-arm64 \
-            dist/reglet-darwin-x64 \
-            dist/reglet-windows-x64.exe \
-            dist/reglet-linux-arm64 \
-            dist/reglet-linux-x64 \
-            dist/desktop/* \
-            dist/SHA256SUMS.txt \
-            dist/provenance.txt
       - name: Update Homebrew tap
         env:
           HOMEBREW_TAP_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}

ROADMAP.md

@@ -12,6 +12,7 @@ Protocol v2 end-to-end encrypted sync (`v2-crypto`, `v2-engine`, SAS comparison,
 - **Milestone 1: Conflict Resolution CLI (`v0.5.12`)** — Shipped ✅ (Actionable conflict output, `reglet sync conflicts` interactive wizard, `reglet sync resolve` CLI command, path normalization)
 - **Milestone 2: Vaulted Secrets Management & MCP Experience (`v0.5.13` - `v0.5.14`)** — Shipped ✅ (`reglet secret set/list/delete/status`, interactive in-flight prompts, automatic OS keychain + encrypted vault sync)
 - **Milestone 3: Ephemeral Local Web Conflict GUI (`v0.5.14`)** — Shipped 🚀 (`reglet sync conflicts --web`, `reglet ui`, zero-knowledge loopback browser diff & one-click resolution)
+- **Milestone 3.5: Minimalist Desktop GUI Overhaul & Onboarding (`v0.5.15`)** — Shipped 🚀 (T3 Code-inspired visual diff center, lightweight custom diff engine, CLI dependency assistant, re-triggerable onboarding, external editor launch, native drag regions)
 - **Milestone 4: AI Smart Merging (`v0.6.0`)** — In Design 📐 (Semantic LLM reconciliation of Markdown instructions and JSON configurations)
 - **Milestone 5: Server Resiliency & Operations (`v0.7.0`)** — Planned 💡 (Coolify zero-downtime persistence, automated SQLite snapshots, multi-vault support)
 

apps/desktop/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reglet/desktop",
-  "version": "0.5.14",
+  "version": "0.5.15",
   "private": true,
   "type": "module",
   "scripts": {

apps/desktop/src-tauri/tauri.conf.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
   "productName": "Reglet",
-  "version": "0.5.14",
+  "version": "0.5.15",
   "identifier": "dev.reglet.desktop",
   "build": {
     "beforeDevCommand": "",

apps/desktop/src/DesktopManager.tsx

@@ -1,17 +1,36 @@
 import { useEffect, useState } from 'react';
 import { ManagerApp, type TauriManagerClient } from '@reglet/manager-ui';
+import { Check, Copy, ExternalLink, RefreshCw } from 'lucide-react';
 import { tauriConnectLinks } from './deepLinks.js';
 import { bootstrapTauriManagerClient, subscribeManagerRuntimeTermination } from './runtimeBootstrap.js';
 import { desktopHostActions } from './updater.js';
 
 export function DesktopManager() {
   const [client, setClient] = useState<TauriManagerClient | null>(null);
   const [error, setError] = useState<string | null>(null);
+  const [copiedIndex, setCopiedIndex] = useState<number | null>(null);
+  const [retrying, setRetrying] = useState(false);
+
+  const connect = () => {
+    setRetrying(true);
+    setClient(null);
+    setError(null);
+    void bootstrapTauriManagerClient()
+      .then((next) => {
+        setClient(next);
+      })
+      .catch((cause: unknown) => {
+        setError(cause instanceof Error ? cause.message : 'The local Manager runtime could not start.');
+      })
+      .finally(() => {
+        setRetrying(false);
+      });
+  };
 
   useEffect(() => {
     let disposed = false;
     let connectionAttempt = 0;
-    const connect = () => {
+    const connectInternal = () => {
       const attempt = ++connectionAttempt;
       setClient(null);
       setError(null);
@@ -23,8 +42,8 @@ export function DesktopManager() {
         }
       });
     };
-    const unsubscribe = subscribeManagerRuntimeTermination(connect);
-    connect();
+    const unsubscribe = subscribeManagerRuntimeTermination(connectInternal);
+    connectInternal();
     return () => { disposed = true; connectionAttempt += 1; unsubscribe(); };
   }, []);
 
@@ -50,12 +69,90 @@ export function DesktopManager() {
     return () => { disposed = true; unlisten?.(); };
   }, [client]);
 
+  const copyCommand = (cmd: string, index: number) => {
+    void navigator.clipboard.writeText(cmd);
+    setCopiedIndex(index);
+    setTimeout(() => setCopiedIndex(null), 2000);
+  };
+
   if (client !== null) return <ManagerApp client={client} hostActions={desktopHostActions} />;
+
+  if (error !== null) {
+    return (
+      <main className="rg-desktop-bootstrap min-h-screen bg-[var(--rg-canvas,#08090b)] text-[var(--rg-text,#f3f3f2)] flex flex-col items-center justify-center p-6 select-none font-sans">
+        <div className="max-w-md w-full bg-[var(--rg-surface,#101216)] border border-[var(--rg-border,rgba(255,255,255,0.08))] rounded-2xl p-6 shadow-2xl space-y-5">
+          <div className="flex items-center gap-3">
+            <span className="rg-desktop-bootstrap__mark shrink-0" aria-hidden="true">R</span>
+            <div>
+              <h1 className="text-base font-semibold tracking-tight text-white m-0">Reglet CLI Required</h1>
+              <p className="text-xs text-[var(--rg-muted,#8a8f98)] m-0 mt-0.5">Background local runtime was not detected.</p>
+            </div>
+          </div>
+
+          <p role="alert" className="text-xs text-amber-300 bg-amber-950/30 border border-amber-800/40 rounded-lg p-3 m-0 leading-relaxed">
+            Reglet Desktop communicates with the encrypted local CLI engine to manage your agents and synced vault. Install the CLI to get started:
+          </p>
+
+          <div className="space-y-2">
+            <div className="text-[11px] font-medium text-[var(--rg-muted,#8a8f98)] uppercase tracking-wider">
+              Installation Options
+            </div>
+
+            {[
+              { label: 'Homebrew (macOS / Linux)', cmd: 'brew install elijahbutler/tap/reglet' },
+              { label: 'Standalone Installer', cmd: 'curl -fsSL https://reglet.cloudview.cc/install.sh -o install.sh && bash install.sh' },
+              { label: 'Bun / Node', cmd: 'bun install -g reglet' },
+            ].map((option, idx) => (
+              <div
+                key={option.label}
+                className="flex items-center justify-between p-2.5 rounded-lg bg-black/40 border border-white/5 group hover:border-white/10 transition-colors"
+              >
+                <div className="min-w-0 pr-2">
+                  <div className="text-[11px] text-[var(--rg-muted,#8a8f98)]">{option.label}</div>
+                  <code className="text-xs text-emerald-400 font-mono truncate block">{option.cmd}</code>
+                </div>
+                <button
+                  type="button"
+                  onClick={() => copyCommand(option.cmd, idx)}
+                  className="p-1.5 rounded bg-white/5 hover:bg-white/10 text-white transition-colors shrink-0"
+                  aria-label={`Copy ${option.label}`}
+                >
+                  {copiedIndex === idx ? <Check size={13} className="text-emerald-400" /> : <Copy size={13} />}
+                </button>
+              </div>
+            ))}
+          </div>
+
+          <div className="flex items-center gap-3 pt-2">
+            <button
+              type="button"
+              onClick={connect}
+              disabled={retrying}
+              className="flex-1 flex items-center justify-center gap-2 py-2 px-4 rounded-lg bg-[var(--rg-coral,#ff6b64)] text-black font-semibold text-xs hover:opacity-95 transition-opacity disabled:opacity-50 cursor-pointer"
+            >
+              <RefreshCw size={13} className={retrying ? 'animate-spin' : ''} />
+              <span>{retrying ? 'Retrying…' : 'Retry Connection'}</span>
+            </button>
+            <a
+              href="https://github.com/elijahbutler/reglet#readme"
+              target="_blank"
+              rel="noreferrer"
+              className="py-2 px-3 rounded-lg border border-white/10 hover:bg-white/5 text-xs text-[var(--rg-muted,#8a8f98)] hover:text-white flex items-center gap-1.5 transition-colors no-underline"
+            >
+              <ExternalLink size={13} />
+              <span>Docs</span>
+            </a>
+          </div>
+        </div>
+      </main>
+    );
+  }
+
   return (
     <main className="rg-desktop-bootstrap">
       <span className="rg-desktop-bootstrap__mark" aria-hidden="true">R</span>
-      <h1>{error === null ? 'Starting Reglet' : 'Manager runtime unavailable'}</h1>
-      <p role={error === null ? undefined : 'alert'}>{error ?? 'Preparing the encrypted local workbench.'}</p>
+      <h1>Starting Reglet</h1>
+      <p>Preparing the encrypted local workbench.</p>
     </main>
   );
 }