@f5xc-salesdemos/xcsh 19.27.1 → 19.28.0

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5xc-salesdemos/xcsh",
-	"version": "19.27.1",
+	"version": "19.28.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/f5xc-salesdemos/xcsh",
 	"author": "Can Boluk",
@@ -50,12 +50,12 @@
 	"dependencies": {
 		"@agentclientprotocol/sdk": "0.16.1",
 		"@mozilla/readability": "^0.6",
-		"@f5xc-salesdemos/xcsh-stats": "19.27.1",
-		"@f5xc-salesdemos/pi-agent-core": "19.27.1",
-		"@f5xc-salesdemos/pi-ai": "19.27.1",
-		"@f5xc-salesdemos/pi-natives": "19.27.1",
-		"@f5xc-salesdemos/pi-tui": "19.27.1",
-		"@f5xc-salesdemos/pi-utils": "19.27.1",
+		"@f5xc-salesdemos/xcsh-stats": "19.28.0",
+		"@f5xc-salesdemos/pi-agent-core": "19.28.0",
+		"@f5xc-salesdemos/pi-ai": "19.28.0",
+		"@f5xc-salesdemos/pi-natives": "19.28.0",
+		"@f5xc-salesdemos/pi-tui": "19.28.0",
+		"@f5xc-salesdemos/pi-utils": "19.28.0",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.20",

package/src/internal-urls/build-info.generated.ts

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "19.27.1",
-	"commit": "733f34673d030878f7fba143e2d2d3d89f3294cc",
-	"shortCommit": "733f346",
+	"version": "19.28.0",
+	"commit": "f5e2cb01ca859d340f3d8803be61d501719c3971",
+	"shortCommit": "f5e2cb0",
 	"branch": "main",
-	"tag": "v19.27.1",
-	"commitDate": "2026-06-11T03:12:32Z",
-	"buildDate": "2026-06-11T03:35:17.807Z",
+	"tag": "v19.28.0",
+	"commitDate": "2026-06-11T13:31:38Z",
+	"buildDate": "2026-06-11T14:03:40.572Z",
 	"dirty": true,
 	"prNumber": "",
 	"repoUrl": "https://github.com/f5xc-salesdemos/xcsh",
 	"repoSlug": "f5xc-salesdemos/xcsh",
-	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/733f34673d030878f7fba143e2d2d3d89f3294cc",
-	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v19.27.1"
+	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/f5e2cb01ca859d340f3d8803be61d501719c3971",
+	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v19.28.0"
 };

package/src/locales/ar.json

@@ -273,6 +273,15 @@
 	"welcome.runLoginReconnect": "شغّل /login لإعادة الاتصال",
 	"welcome.noModelProvider": "لم يتم تكوين مزود نموذج",
 	"welcome.runLoginConnect": "شغّل /login للاتصال",
+	"login.wizard.urlPrompt": "Model Provider URL",
+	"login.wizard.urlPlaceholder": "https://your-proxy.example.com",
+	"login.wizard.apiKeyPrompt": "API Key",
+	"login.wizard.apiKeyPlaceholder": "sk-...",
+	"login.wizard.connecting": "Connecting to {url}…",
+	"login.wizard.success": "Connected — {count} models available",
+	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
+	"login.wizard.failed": "Connection failed — {error}",
+	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
 	"plugins.tabs.installed": "مثبتة",
 	"plugins.tabs.recommended": "موصى بها",
 	"plugins.tabs.discover": "استكشاف",

package/src/locales/de.json

@@ -273,6 +273,15 @@
 	"welcome.runLoginReconnect": "Führen Sie /login aus, um die Verbindung wiederherzustellen",
 	"welcome.noModelProvider": "Kein Modellanbieter konfiguriert",
 	"welcome.runLoginConnect": "Führen Sie /login aus, um sich zu verbinden",
+	"login.wizard.urlPrompt": "Model Provider URL",
+	"login.wizard.urlPlaceholder": "https://your-proxy.example.com",
+	"login.wizard.apiKeyPrompt": "API Key",
+	"login.wizard.apiKeyPlaceholder": "sk-...",
+	"login.wizard.connecting": "Connecting to {url}…",
+	"login.wizard.success": "Connected — {count} models available",
+	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
+	"login.wizard.failed": "Connection failed — {error}",
+	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
 	"plugins.tabs.installed": "Installiert",
 	"plugins.tabs.recommended": "Empfohlen",
 	"plugins.tabs.discover": "Entdecken",

package/src/locales/en.json

@@ -291,6 +291,15 @@
 	"welcome.runLoginReconnect": "Run /login to reconnect",
 	"welcome.noModelProvider": "No model provider configured",
 	"welcome.runLoginConnect": "Run /login to connect",
+	"login.wizard.urlPrompt": "Model Provider URL",
+	"login.wizard.urlPlaceholder": "https://your-proxy.example.com",
+	"login.wizard.apiKeyPrompt": "API Key",
+	"login.wizard.apiKeyPlaceholder": "sk-...",
+	"login.wizard.connecting": "Connecting to {url}…",
+	"login.wizard.success": "Connected — {count} models available",
+	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
+	"login.wizard.failed": "Connection failed — {error}",
+	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
 
 	"plugins.tabs.installed": "Installed",
 	"plugins.tabs.recommended": "Recommended",

package/src/locales/es.json

@@ -273,6 +273,15 @@
 	"welcome.runLoginReconnect": "Ejecute /login para reconectar",
 	"welcome.noModelProvider": "No hay proveedor de modelo configurado",
 	"welcome.runLoginConnect": "Ejecute /login para conectar",
+	"login.wizard.urlPrompt": "Model Provider URL",
+	"login.wizard.urlPlaceholder": "https://your-proxy.example.com",
+	"login.wizard.apiKeyPrompt": "API Key",
+	"login.wizard.apiKeyPlaceholder": "sk-...",
+	"login.wizard.connecting": "Connecting to {url}…",
+	"login.wizard.success": "Connected — {count} models available",
+	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
+	"login.wizard.failed": "Connection failed — {error}",
+	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
 	"plugins.tabs.installed": "Instalados",
 	"plugins.tabs.recommended": "Recomendados",
 	"plugins.tabs.discover": "Descubrir",

package/src/locales/fr.json

@@ -273,6 +273,15 @@
 	"welcome.runLoginReconnect": "Exécutez /login pour vous reconnecter",
 	"welcome.noModelProvider": "Aucun fournisseur de modèle configuré",
 	"welcome.runLoginConnect": "Exécutez /login pour vous connecter",
+	"login.wizard.urlPrompt": "Model Provider URL",
+	"login.wizard.urlPlaceholder": "https://your-proxy.example.com",
+	"login.wizard.apiKeyPrompt": "API Key",
+	"login.wizard.apiKeyPlaceholder": "sk-...",
+	"login.wizard.connecting": "Connecting to {url}…",
+	"login.wizard.success": "Connected — {count} models available",
+	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
+	"login.wizard.failed": "Connection failed — {error}",
+	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
 	"plugins.tabs.installed": "Installés",
 	"plugins.tabs.recommended": "Recommandés",
 	"plugins.tabs.discover": "Découvrir",

package/src/locales/hi.json

@@ -273,6 +273,15 @@
 	"welcome.runLoginReconnect": "पुनः कनेक्ट करने के लिए /login चलाएँ",
 	"welcome.noModelProvider": "कोई मॉडल प्रदाता कॉन्फ़िगर नहीं है",
 	"welcome.runLoginConnect": "कनेक्ट करने के लिए /login चलाएँ",
+	"login.wizard.urlPrompt": "Model Provider URL",
+	"login.wizard.urlPlaceholder": "https://your-proxy.example.com",
+	"login.wizard.apiKeyPrompt": "API Key",
+	"login.wizard.apiKeyPlaceholder": "sk-...",
+	"login.wizard.connecting": "Connecting to {url}…",
+	"login.wizard.success": "Connected — {count} models available",
+	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
+	"login.wizard.failed": "Connection failed — {error}",
+	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
 	"plugins.tabs.installed": "इंस्टॉल किए गए",
 	"plugins.tabs.recommended": "अनुशंसित",
 	"plugins.tabs.discover": "खोजें",

package/src/locales/it.json

@@ -273,6 +273,15 @@
 	"welcome.runLoginReconnect": "Esegui /login per riconnetterti",
 	"welcome.noModelProvider": "Nessun provider del modello configurato",
 	"welcome.runLoginConnect": "Esegui /login per connetterti",
+	"login.wizard.urlPrompt": "Model Provider URL",
+	"login.wizard.urlPlaceholder": "https://your-proxy.example.com",
+	"login.wizard.apiKeyPrompt": "API Key",
+	"login.wizard.apiKeyPlaceholder": "sk-...",
+	"login.wizard.connecting": "Connecting to {url}…",
+	"login.wizard.success": "Connected — {count} models available",
+	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
+	"login.wizard.failed": "Connection failed — {error}",
+	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
 	"plugins.tabs.installed": "Installati",
 	"plugins.tabs.recommended": "Consigliati",
 	"plugins.tabs.discover": "Scopri",

package/src/locales/ja.json

@@ -273,6 +273,15 @@
 	"welcome.runLoginReconnect": "/login を実行して再接続してください",
 	"welcome.noModelProvider": "モデルプロバイダーが設定されていません",
 	"welcome.runLoginConnect": "/login を実行して接続してください",
+	"login.wizard.urlPrompt": "Model Provider URL",
+	"login.wizard.urlPlaceholder": "https://your-proxy.example.com",
+	"login.wizard.apiKeyPrompt": "API Key",
+	"login.wizard.apiKeyPlaceholder": "sk-...",
+	"login.wizard.connecting": "Connecting to {url}…",
+	"login.wizard.success": "Connected — {count} models available",
+	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
+	"login.wizard.failed": "Connection failed — {error}",
+	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
 	"plugins.tabs.installed": "インストール済み",
 	"plugins.tabs.recommended": "推奨",
 	"plugins.tabs.discover": "検索",

package/src/locales/ko.json

@@ -273,6 +273,15 @@
 	"welcome.runLoginReconnect": "/login을 실행하여 재연결하세요",
 	"welcome.noModelProvider": "모델 프로바이더가 설정되지 않았습니다",
 	"welcome.runLoginConnect": "/login을 실행하여 연결하세요",
+	"login.wizard.urlPrompt": "Model Provider URL",
+	"login.wizard.urlPlaceholder": "https://your-proxy.example.com",
+	"login.wizard.apiKeyPrompt": "API Key",
+	"login.wizard.apiKeyPlaceholder": "sk-...",
+	"login.wizard.connecting": "Connecting to {url}…",
+	"login.wizard.success": "Connected — {count} models available",
+	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
+	"login.wizard.failed": "Connection failed — {error}",
+	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
 	"plugins.tabs.installed": "설치됨",
 	"plugins.tabs.recommended": "권장",
 	"plugins.tabs.discover": "검색",

package/src/locales/pt-br.json

@@ -273,6 +273,15 @@
 	"welcome.runLoginReconnect": "Execute /login para reconectar",
 	"welcome.noModelProvider": "Nenhum provedor de modelo configurado",
 	"welcome.runLoginConnect": "Execute /login para conectar",
+	"login.wizard.urlPrompt": "Model Provider URL",
+	"login.wizard.urlPlaceholder": "https://your-proxy.example.com",
+	"login.wizard.apiKeyPrompt": "API Key",
+	"login.wizard.apiKeyPlaceholder": "sk-...",
+	"login.wizard.connecting": "Connecting to {url}…",
+	"login.wizard.success": "Connected — {count} models available",
+	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
+	"login.wizard.failed": "Connection failed — {error}",
+	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
 	"plugins.tabs.installed": "Instalados",
 	"plugins.tabs.recommended": "Recomendados",
 	"plugins.tabs.discover": "Descobrir",

package/src/locales/th.json

@@ -273,6 +273,15 @@
 	"welcome.runLoginReconnect": "รัน /login เพื่อเชื่อมต่อใหม่",
 	"welcome.noModelProvider": "ยังไม่ได้กำหนดค่าผู้ให้บริการโมเดล",
 	"welcome.runLoginConnect": "รัน /login เพื่อเชื่อมต่อ",
+	"login.wizard.urlPrompt": "Model Provider URL",
+	"login.wizard.urlPlaceholder": "https://your-proxy.example.com",
+	"login.wizard.apiKeyPrompt": "API Key",
+	"login.wizard.apiKeyPlaceholder": "sk-...",
+	"login.wizard.connecting": "Connecting to {url}…",
+	"login.wizard.success": "Connected — {count} models available",
+	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
+	"login.wizard.failed": "Connection failed — {error}",
+	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
 	"plugins.tabs.installed": "ติดตั้งแล้ว",
 	"plugins.tabs.recommended": "แนะนำ",
 	"plugins.tabs.discover": "ค้นหา",

package/src/locales/zh-cn.json

@@ -273,6 +273,15 @@
 	"welcome.runLoginReconnect": "运行 /login 重新连接",
 	"welcome.noModelProvider": "未配置模型提供商",
 	"welcome.runLoginConnect": "运行 /login 连接",
+	"login.wizard.urlPrompt": "Model Provider URL",
+	"login.wizard.urlPlaceholder": "https://your-proxy.example.com",
+	"login.wizard.apiKeyPrompt": "API Key",
+	"login.wizard.apiKeyPlaceholder": "sk-...",
+	"login.wizard.connecting": "Connecting to {url}…",
+	"login.wizard.success": "Connected — {count} models available",
+	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
+	"login.wizard.failed": "Connection failed — {error}",
+	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
 	"plugins.tabs.installed": "已安装",
 	"plugins.tabs.recommended": "推荐",
 	"plugins.tabs.discover": "发现",

package/src/locales/zh-tw.json

@@ -273,6 +273,15 @@
 	"welcome.runLoginReconnect": "執行 /login 重新連線",
 	"welcome.noModelProvider": "未設定模型供應商",
 	"welcome.runLoginConnect": "執行 /login 連線",
+	"login.wizard.urlPrompt": "Model Provider URL",
+	"login.wizard.urlPlaceholder": "https://your-proxy.example.com",
+	"login.wizard.apiKeyPrompt": "API Key",
+	"login.wizard.apiKeyPlaceholder": "sk-...",
+	"login.wizard.connecting": "Connecting to {url}…",
+	"login.wizard.success": "Connected — {count} models available",
+	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
+	"login.wizard.failed": "Connection failed — {error}",
+	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
 	"plugins.tabs.installed": "已安裝",
 	"plugins.tabs.recommended": "推薦",
 	"plugins.tabs.discover": "探索",

package/src/modes/controllers/selector-controller.ts

@@ -5,7 +5,7 @@ import { ThinkingLevel } from "@f5xc-salesdemos/pi-agent-core";
 import { getOAuthProviders, loginLiteLLM, type OAuthProvider } from "@f5xc-salesdemos/pi-ai";
 import type { Component } from "@f5xc-salesdemos/pi-tui";
 import { Input, Loader, Spacer, Text } from "@f5xc-salesdemos/pi-tui";
-import { getAgentDbPath, getAgentDir, getConfigDirName, getProjectDir } from "@f5xc-salesdemos/pi-utils";
+import { getAgentDbPath, getAgentDir, getConfigDirName, getProjectDir, t } from "@f5xc-salesdemos/pi-utils";
 import { invalidate as invalidateFsCache } from "../../capability/fs";
 import {
 	generateConfigYml,
@@ -1038,6 +1038,169 @@ export class SelectorController {
 		}
 	}
 
+	async showFirstRunLogin(): Promise<void> {
+		const modelsPath = path.join(getAgentDir(), "models.yml");
+
+		// Prompt helper: renders label + hint + input together in the editor
+		// container so they're always visible below the welcome branding.
+		const promptInput = async (message: string, placeholder?: string): Promise<string | null> => {
+			const { promise, resolve } = Promise.withResolvers<string | null>();
+			const input = new Input();
+			input.onSubmit = () => {
+				const raw = input.getValue();
+				const value = raw.replace(/\x1b\[\d{3}~/g, "").replace(/\x1b[[\]()][^\x1b]*/g, "");
+				this.ctx.editorContainer.clear();
+				this.ctx.editorContainer.addChild(this.ctx.editor);
+				this.ctx.ui.setFocus(this.ctx.editor);
+				resolve(value);
+			};
+			input.onEscape = () => {
+				this.ctx.editorContainer.clear();
+				this.ctx.editorContainer.addChild(this.ctx.editor);
+				this.ctx.ui.setFocus(this.ctx.editor);
+				resolve(null);
+			};
+
+			// Pack label + hint + input into the editor area as a single block
+			this.ctx.editorContainer.clear();
+			this.ctx.editorContainer.addChild(new Spacer(1));
+			this.ctx.editorContainer.addChild(new Text(theme.bold(theme.fg("text", ` ${message}`)), 0, 0));
+			if (placeholder) {
+				this.ctx.editorContainer.addChild(new Text(theme.fg("dim", `  ${placeholder}`), 0, 0));
+			}
+			this.ctx.editorContainer.addChild(new Spacer(1));
+			this.ctx.editorContainer.addChild(input);
+			this.ctx.ui.setFocus(input);
+			this.ctx.ui.requestRender();
+			return promise;
+		};
+
+		try {
+			// Step 1: URL prompt
+			let baseUrl: string | null = null;
+			while (!baseUrl) {
+				const urlInput = await promptInput(t("login.wizard.urlPrompt"), t("login.wizard.urlPlaceholder"));
+				if (urlInput === null) return; // Escape pressed
+				const trimmed = urlInput.trim();
+				if (!trimmed) continue;
+				if (!trimmed.startsWith("http://") && !trimmed.startsWith("https://")) {
+					this.ctx.chatContainer.addChild(
+						new Text(theme.fg("error", "URL must start with http:// or https://"), 1, 0),
+					);
+					this.ctx.ui.requestRender();
+					continue;
+				}
+				baseUrl = trimmed.replace(/\/+$/, "");
+			}
+
+			// Auto-detect known providers by hostname
+			try {
+				const hostname = new URL(baseUrl).hostname.toLowerCase();
+				const providerMap: Record<string, string> = {
+					"api.anthropic.com": "anthropic",
+					"api.openai.com": "openai-codex",
+					"api.together.xyz": "together",
+				};
+				const detectedProvider =
+					providerMap[hostname] ?? (hostname.endsWith(".googleapis.com") ? "google-gemini-cli" : null);
+				if (detectedProvider) {
+					this.ctx.editorContainer.clear();
+					this.ctx.editorContainer.addChild(new Spacer(1));
+					this.ctx.editorContainer.addChild(
+						new Text(theme.fg("dim", `Detected ${detectedProvider} — launching login…`), 1, 0),
+					);
+					this.ctx.ui.requestRender();
+					await this.#handleOAuthLogin(detectedProvider);
+					return;
+				}
+			} catch {
+				// URL parse failed — continue with proxy flow
+			}
+
+			// Step 2: API Key prompt (for non-OAuth proxy)
+			let apiKey: string | null = null;
+			let probeSuccess = false;
+
+			while (!probeSuccess) {
+				if (!apiKey) {
+					const keyInput = await promptInput(t("login.wizard.apiKeyPrompt"), t("login.wizard.apiKeyPlaceholder"));
+					if (keyInput === null) return;
+					const trimmedKey = keyInput.trim();
+					if (!trimmedKey) continue;
+					apiKey = trimmedKey;
+				}
+
+				// Show connection status in editor area
+				this.ctx.editorContainer.clear();
+				this.ctx.editorContainer.addChild(new Spacer(1));
+				this.ctx.editorContainer.addChild(
+					new Text(theme.fg("dim", ` ${t("login.wizard.connecting", { url: baseUrl })}`), 0, 0),
+				);
+				this.ctx.ui.requestRender();
+
+				let probe = await probeLiteLLMConnection(baseUrl, apiKey);
+
+				// Auto-retry once on network errors
+				if (!probe.reachable && probe.error && !/\b(401|403|Unauthorized|Forbidden)\b/i.test(probe.error)) {
+					await new Promise(resolve => setTimeout(resolve, 1000));
+					probe = await probeLiteLLMConnection(baseUrl, apiKey);
+				}
+
+				if (probe.reachable) {
+					// Auto-select best model
+					const preferenceOrder = ["claude-opus", "claude-sonnet", "claude", "gpt-4", "gpt"];
+					let selectedModel: string | undefined;
+					for (const pref of preferenceOrder) {
+						selectedModel = probe.models.find(m => m.toLowerCase().includes(pref));
+						if (selectedModel) break;
+					}
+					if (!selectedModel && probe.models.length > 0) {
+						selectedModel = probe.models[0];
+					}
+
+					// Save config
+					const yml = generateModelsYml(baseUrl, {
+						apiBasePath: probe.apiBasePath,
+						apiKeyLiteral: apiKey,
+					});
+					fs.mkdirSync(path.dirname(modelsPath), { recursive: true, mode: 0o700 });
+					fs.writeFileSync(modelsPath, yml, { mode: 0o600 });
+
+					const configPath = path.join(path.dirname(modelsPath), "config.yml");
+					if (!fs.existsSync(configPath)) {
+						fs.writeFileSync(configPath, generateConfigYml());
+					}
+					healConfigYmlModelRoles(configPath);
+
+					await this.ctx.session.modelRegistry.refresh("online");
+					await this.ctx.refreshWelcomeAfterLogin();
+					probeSuccess = true;
+				} else {
+					const errorMsg = probe.error ?? "connection failed";
+
+					// Classify error and re-prompt the appropriate field
+					const isAuthError = /\b(401|403|Unauthorized|Forbidden)\b/i.test(errorMsg);
+					if (isAuthError) {
+						apiKey = null;
+					} else {
+						const urlRetry = await promptInput(
+							`${theme.status.error} ${t("login.wizard.failed", { error: errorMsg })}\n\n ${t("login.wizard.urlPrompt")}`,
+							baseUrl,
+						);
+						if (urlRetry === null) return;
+						const trimmedUrl = urlRetry.trim();
+						if (trimmedUrl && (trimmedUrl.startsWith("http://") || trimmedUrl.startsWith("https://"))) {
+							baseUrl = trimmedUrl.replace(/\/+$/, "");
+						}
+						apiKey = null;
+					}
+				}
+			}
+		} catch (error: unknown) {
+			this.ctx.showError(`Login failed: ${error instanceof Error ? error.message : String(error)}`);
+		}
+	}
+
 	async showOAuthSelector(mode: "login" | "logout", providerId?: string): Promise<void> {
 		if (providerId) {
 			if (mode === "login") {

package/src/modes/interactive-mode.ts

@@ -32,6 +32,7 @@ import { seedComputerProfile } from "../internal-urls/computer-profile";
 import { reconcileFromCollectors } from "../internal-urls/user-profile";
 import { renameApprovedPlanFile } from "../plan-mode/approved-plan";
 import planModeApprovedPrompt from "../prompts/system/plan-mode-approved.md" with { type: "text" };
+import { ContextService } from "../services/f5xc-context";
 import type { AgentSession, AgentSessionEvent } from "../session/agent-session";
 import { HistoryStorage } from "../session/history-storage";
 import type { SessionContext, SessionManager } from "../session/session-manager";
@@ -336,34 +337,43 @@ export class InteractiveMode implements InteractiveModeContext {
 			this.ui.addChild(new Spacer(1));
 		}
 
+		// When model is not connected, the wizard will auto-launch — show a clean
+		// welcome screen without plugins or confusing provider names.
+		const needsLogin = welcomeResult.model.state === "no_provider" || welcomeResult.model.state === "auth_error";
+		const welcomeModelStatus = needsLogin
+			? { state: "no_provider" as const, provider: undefined }
+			: welcomeResult.model;
+
 		const services: ServiceStatus[] =
-			!startupQuiet && welcomeResult.model.state === "connected"
-				? [mapContextStatus(welcomeResult.context ?? { state: "no_context" })]
-				: [];
+			!startupQuiet && !needsLogin ? [mapContextStatus(welcomeResult.context ?? { state: "no_context" })] : [];
 
 		// Build unified plugin list from service status contributions + marketplace
+		// Skip when model is not configured — nothing works without a model.
 		const pluginContributions = this.session.extensionRunner?.getAllRegisteredServiceStatuses() ?? [];
-		const plugins = !startupQuiet ? await buildUnifiedPluginList(pluginContributions).catch(() => []) : [];
+		const plugins =
+			!startupQuiet && !needsLogin ? await buildUnifiedPluginList(pluginContributions).catch(() => []) : [];
 		this.#currentPlugins = plugins;
 
 		const fixableServices: FixableService[] = [];
-		for (const contribution of pluginContributions) {
-			if (contribution.fix) {
-				const plugin = plugins.find(p => p.name.toLowerCase() === contribution.name.toLowerCase());
-				if (plugin && plugin.state === "unauthenticated") {
-					fixableServices.push({
-						name: contribution.name,
-						prompt: contribution.fix.prompt,
-						command: contribution.fix.command,
-						recheck: async () => {
-							try {
-								const result = await contribution.check();
-								return { name: contribution.name, ...result };
-							} catch {
-								return { name: contribution.name, state: "unavailable" as const, hint: "recheck failed" };
-							}
-						},
-					});
+		if (!needsLogin) {
+			for (const contribution of pluginContributions) {
+				if (contribution.fix) {
+					const plugin = plugins.find(p => p.name.toLowerCase() === contribution.name.toLowerCase());
+					if (plugin && plugin.state === "unauthenticated") {
+						fixableServices.push({
+							name: contribution.name,
+							prompt: contribution.fix.prompt,
+							command: contribution.fix.command,
+							recheck: async () => {
+								try {
+									const result = await contribution.check();
+									return { name: contribution.name, ...result };
+								} catch {
+									return { name: contribution.name, state: "unavailable" as const, hint: "recheck failed" };
+								}
+							},
+						});
+					}
 				}
 			}
 		}
@@ -371,7 +381,7 @@ export class InteractiveMode implements InteractiveModeContext {
 		if (!startupQuiet) {
 			this.#welcomeComponent = new WelcomeComponent(
 				this.#version,
-				welcomeResult.model,
+				welcomeModelStatus,
 				services,
 				this.#initialUpdateStatus,
 				[],
@@ -395,6 +405,11 @@ export class InteractiveMode implements InteractiveModeContext {
 		this.ui.addChild(this.hookWidgetContainerBelow);
 		this.ui.setFocus(this.editor);
 
+		// Auto-launch login wizard when model provider is missing or unreachable
+		if (needsLogin) {
+			queueMicrotask(() => void this.#selectorController.showFirstRunLogin());
+		}
+
 		this.#inputController.setupKeyHandlers();
 		this.#inputController.setupEditorSubmitHandler();
 
@@ -1449,6 +1464,49 @@ export class InteractiveMode implements InteractiveModeContext {
 		this.#observerRegistry.setMainSession(this.sessionManager.getSessionFile() ?? undefined);
 	}
 
+	async refreshWelcomeAfterLogin(): Promise<void> {
+		this.#welcomeComponent?.setModelStatus({ state: "connected", provider: "anthropic" });
+
+		// Validate F5 XC Context independently — call validateToken() for a live
+		// check instead of reading cached state (which may be "unknown" if
+		// validation hasn't run yet in this session).
+		const services: ServiceStatus[] = [];
+		try {
+			const ctxService = ContextService.instance;
+			const ctxStatus = ctxService.getStatus();
+			if (ctxStatus.isConfigured) {
+				const name = ctxStatus.activeContextTenant ?? ctxStatus.activeContextName ?? undefined;
+				const result = await ctxService.validateToken({ timeoutMs: 5000 });
+				services.push(
+					mapContextStatus({
+						state:
+							result.status === "connected"
+								? "connected"
+								: result.status === "auth_error"
+									? "auth_error"
+									: "offline",
+						name,
+					}),
+				);
+			}
+		} catch {
+			// ContextService not initialized — skip
+		}
+		this.#welcomeComponent?.setServices(services);
+
+		// Run plugin checks and update the welcome screen
+		const pluginContributions = this.session.extensionRunner?.getAllRegisteredServiceStatuses() ?? [];
+		const plugins = await buildUnifiedPluginList(pluginContributions).catch(() => []);
+		this.#currentPlugins = plugins;
+		this.#welcomeComponent?.setPlugins(plugins);
+
+		// Restore editor
+		this.editorContainer.clear();
+		this.editorContainer.addChild(this.editor);
+		this.ui.setFocus(this.editor);
+		this.ui.requestRender();
+	}
+
 	handleBashCommand(command: string, excludeFromContext?: boolean): Promise<void> {
 		return this.#commandController.handleBashCommand(command, excludeFromContext);
 	}

package/src/modes/types.ts

@@ -213,6 +213,7 @@ export interface InteractiveModeContext {
 	showDebugSelector(): void;
 	showSessionObserver(): void;
 	resetObserverRegistry(): void;
+	refreshWelcomeAfterLogin(): Promise<void>;
 
 	// Input handling
 	handleCtrlC(): void;