From 62008fb408674fea07f221bf66d81e6d46f3cff6 Mon Sep 17 00:00:00 2001
From: timkjr <timkjr@k-lab.lan>
Date: Fri, 31 Jul 2026 11:20:15 -0500
Subject: [PATCH 1/2] fix(welcome): gate Gemini button on availability, drop
 unconditional tunnel button

- Remove the always-visible Cloudflare Tunnel welcome button and QR
  widget; offering it regardless of whether cloudflared is installed
  is a bad default.
- Hide the "Run Gemini" welcome button by default and only show it
  when /api/gemini/status reports available:true, via new
  loadGeminiAvailability() called from showWelcome().
---
 src/web/public/index.html     | 10 +---------
 src/web/public/settings-ui.js | 13 +++++++++++++
 src/web/public/terminal-ui.js |  1 +
 3 files changed, 15 insertions(+), 9 deletions(-)

diff --git a/src/web/public/index.html b/src/web/public/index.html
index adb3d8f4..770cffcc 100644
--- a/src/web/public/index.html
+++ b/src/web/public/index.html
@@ -315,23 +315,15 @@
               <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polygon points="5 3 19 12 5 21 5 3"/></svg>
               Run Claude Code
             </button>
-            <button class="welcome-btn welcome-btn-tunnel" id="welcomeTunnelBtn" onclick="app.toggleTunnelFromWelcome()">
-              <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 2L2 7l10 5 10-5-10-5z"/><path d="M2 17l10 5 10-5"/><path d="M2 12l10 5 10-5"/></svg>
-              Cloudflare Tunnel
-            </button>
             <button class="welcome-btn welcome-btn-opencode" onclick="app.setRunMode('opencode'); app.runOpenCode()">
               <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polygon points="5 3 19 12 5 21 5 3"/></svg>
               Run OpenCode
             </button>
-            <button class="welcome-btn welcome-btn-gemini" onclick="app.setRunMode('gemini'); app.runGemini()">
+            <button class="welcome-btn welcome-btn-gemini" id="welcomeGeminiBtn" style="display: none;" onclick="app.setRunMode('gemini'); app.runGemini()">
               <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polygon points="5 3 19 12 5 21 5 3"/></svg>
               Run Gemini
             </button>
           </div>
-          <div class="welcome-qr" id="welcomeQr" onclick="app.toggleWelcomeQrSize()">
-            <div class="welcome-qr-inner" id="welcomeQrInner"></div>
-            <div class="welcome-qr-url" id="welcomeQrUrl"></div>
-          </div>
           <div class="history-sessions" id="historySessions" style="display:none">
             <div class="search-panel" id="searchPanel">
               <div class="search-input-row">
diff --git a/src/web/public/settings-ui.js b/src/web/public/settings-ui.js
index 36d06214..a8eb46fd 100644
--- a/src/web/public/settings-ui.js
+++ b/src/web/public/settings-ui.js
@@ -694,6 +694,19 @@ Object.assign(CodemanApp.prototype, {
     this._updatePollTimer = setInterval(poll, 1500);
   },
 
+  async loadGeminiAvailability() {
+    const btn = document.getElementById('welcomeGeminiBtn');
+    if (!btn) return;
+    try {
+      const res = await fetch('/api/gemini/status');
+      const env = await res.json();
+      const status = env?.success === true ? env.data : env;
+      btn.style.display = status?.available ? 'flex' : 'none';
+    } catch {
+      btn.style.display = 'none';
+    }
+  },
+
   async loadTunnelStatus() {
     try {
       const res = await fetch('/api/tunnel/status');
diff --git a/src/web/public/terminal-ui.js b/src/web/public/terminal-ui.js
index f19f37ee..4fe01c19 100644
--- a/src/web/public/terminal-ui.js
+++ b/src/web/public/terminal-ui.js
@@ -1195,6 +1195,7 @@ Object.assign(CodemanApp.prototype, {
     if (overlay) {
       overlay.classList.add('visible');
       this.loadTunnelStatus();
+      this.loadGeminiAvailability();
       this.loadHistorySessions();
       this.initSearchPanel();
     }

From 3ea1ea28f0edb982b8416db125225daafc67c8d0 Mon Sep 17 00:00:00 2001
From: timkjr <timkjr@k-lab.lan>
Date: Sat, 1 Aug 2026 21:55:33 -0500
Subject: [PATCH 2/2] fix(welcome): gate Claude and Opencode buttons on CLI
 availability too
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Extends the Gemini gating from bb7fb9e to the other welcome-screen
buttons that had the same problem: shown unconditionally even when the
underlying CLI isn't installed.

- Add isClaudeAvailable() (claude-cli-resolver.ts) and GET
  /api/claude/status, mirroring the existing opencode/codex/gemini
  resolvers and status endpoints.
- Opencode already had a working /api/opencode/status the welcome
  screen just wasn't checking; wire it up the same way.
- Refactor loadGeminiAvailability() into a shared
  _loadCliAvailability(buttonId, statusUrl) helper instead of
  duplicating the fetch/try-catch three times.

Run-mode dropdown entries (Opencode/Codex) are intentionally left
unconditional here — follow-up PR.
---
 src/utils/claude-cli-resolver.ts |  9 +++++++++
 src/web/public/index.html        |  4 ++--
 src/web/public/settings-ui.js    | 16 ++++++++++++++--
 src/web/public/terminal-ui.js    |  2 ++
 src/web/routes/system-routes.ts  | 12 +++++++++++-
 5 files changed, 38 insertions(+), 5 deletions(-)

diff --git a/src/utils/claude-cli-resolver.ts b/src/utils/claude-cli-resolver.ts
index b9292201..6d735fa5 100644
--- a/src/utils/claude-cli-resolver.ts
+++ b/src/utils/claude-cli-resolver.ts
@@ -26,6 +26,15 @@ const CLAUDE_SEARCH_DIRS = [
 /** Cached directory containing the claude binary (empty string = searched but not found) */
 let _claudeDir: string | null = null;
 
+/**
+ * Returns true if the Claude CLI binary can be located (via `which` or one of
+ * the common install directories). Mirrors `isGeminiAvailable`/`isOpenCodeAvailable`/
+ * `isCodexAvailable` in the sibling resolvers.
+ */
+export function isClaudeAvailable(): boolean {
+  return findClaudeDir() !== null;
+}
+
 /**
  * Finds the directory containing the `claude` binary.
  * Checks `which claude` first, then falls back to common install locations.
diff --git a/src/web/public/index.html b/src/web/public/index.html
index 770cffcc..a9b6a0f6 100644
--- a/src/web/public/index.html
+++ b/src/web/public/index.html
@@ -311,11 +311,11 @@
           <h1 class="welcome-title">Codeman</h1>
           <p class="welcome-desc">Manage AI Coding tools in persistent tmux sessions.</p>
           <div class="welcome-actions">
-            <button class="welcome-btn welcome-btn-claude" onclick="app.setRunMode('claude'); app.runClaude()">
+            <button class="welcome-btn welcome-btn-claude" id="welcomeClaudeBtn" style="display: none;" onclick="app.setRunMode('claude'); app.runClaude()">
               <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polygon points="5 3 19 12 5 21 5 3"/></svg>
               Run Claude Code
             </button>
-            <button class="welcome-btn welcome-btn-opencode" onclick="app.setRunMode('opencode'); app.runOpenCode()">
+            <button class="welcome-btn welcome-btn-opencode" id="welcomeOpencodeBtn" style="display: none;" onclick="app.setRunMode('opencode'); app.runOpenCode()">
               <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polygon points="5 3 19 12 5 21 5 3"/></svg>
               Run OpenCode
             </button>
diff --git a/src/web/public/settings-ui.js b/src/web/public/settings-ui.js
index a8eb46fd..58a98da1 100644
--- a/src/web/public/settings-ui.js
+++ b/src/web/public/settings-ui.js
@@ -695,10 +695,22 @@ Object.assign(CodemanApp.prototype, {
   },
 
   async loadGeminiAvailability() {
-    const btn = document.getElementById('welcomeGeminiBtn');
+    await this._loadCliAvailability('welcomeGeminiBtn', '/api/gemini/status');
+  },
+
+  async loadClaudeAvailability() {
+    await this._loadCliAvailability('welcomeClaudeBtn', '/api/claude/status');
+  },
+
+  async loadOpencodeAvailability() {
+    await this._loadCliAvailability('welcomeOpencodeBtn', '/api/opencode/status');
+  },
+
+  async _loadCliAvailability(buttonId, statusUrl) {
+    const btn = document.getElementById(buttonId);
     if (!btn) return;
     try {
-      const res = await fetch('/api/gemini/status');
+      const res = await fetch(statusUrl);
       const env = await res.json();
       const status = env?.success === true ? env.data : env;
       btn.style.display = status?.available ? 'flex' : 'none';
diff --git a/src/web/public/terminal-ui.js b/src/web/public/terminal-ui.js
index 4fe01c19..1449981c 100644
--- a/src/web/public/terminal-ui.js
+++ b/src/web/public/terminal-ui.js
@@ -1195,6 +1195,8 @@ Object.assign(CodemanApp.prototype, {
     if (overlay) {
       overlay.classList.add('visible');
       this.loadTunnelStatus();
+      this.loadClaudeAvailability();
+      this.loadOpencodeAvailability();
       this.loadGeminiAvailability();
       this.loadHistorySessions();
       this.initSearchPanel();
diff --git a/src/web/routes/system-routes.ts b/src/web/routes/system-routes.ts
index 4715ac91..64e43c76 100644
--- a/src/web/routes/system-routes.ts
+++ b/src/web/routes/system-routes.ts
@@ -374,9 +374,19 @@ export function registerSystemRoutes(
   });
 
   // ═══════════════════════════════════════════════════════════════
-  // CLI Integrations (OpenCode, Codex, Gemini, Antigravity)
+  // CLI Integrations (Claude, OpenCode, Codex, Gemini, Antigravity)
   // ═══════════════════════════════════════════════════════════════
 
+  // ========== Claude ==========
+
+  app.get('/api/claude/status', async () => {
+    const { isClaudeAvailable, findClaudeDir } = await import('../../utils/claude-cli-resolver.js');
+    return {
+      available: isClaudeAvailable(),
+      path: findClaudeDir(),
+    };
+  });
+
   // ========== OpenCode ==========
 
   app.get('/api/opencode/status', async () => {