feat: effort levels, context usage persistence, and UI polish

- Add Claude effort level support (low/medium/high/max) with model-aware picker in dropdown
- Persist context usage across all engines and background sessions
- Queue permission requests to prevent double-response races
- Add auto-expand tools toggle, Skill tool renderer, and background agent dismiss UX
- Overhaul welcome screen with time-aware greetings and mood-colored ambient backgrounds
- Polish flat mode headers, light glass sidebar transparency, and traffic light positioning

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: OpenSource03

electron/src/ipc/claude-sessions.ts

@@ -66,6 +66,7 @@ function summarizeSpawnOptions(options: Record<string, unknown>): Record<string,
     model: options.model,
     includePartialMessages: options.includePartialMessages,
     thinking: options.thinking,
+    effort: options.effort,
     settingSources: options.settingSources,
     enableFileCheckpointing: options.enableFileCheckpointing,
     extraArgs: options.extraArgs,
@@ -236,6 +237,7 @@ interface StartOptions {
   model?: string;
   permissionMode?: string;
   thinkingEnabled?: boolean;
+  effort?: "low" | "medium" | "high" | "max";
   resume?: string;
   /** Fork to a new session ID when resuming (model forgets messages after resumeSessionAt) */
   forkSession?: boolean;
@@ -244,10 +246,8 @@ interface StartOptions {
   mcpServers?: McpServerInput[];
 }
 
-function buildThinkingConfig(thinkingEnabled?: boolean): { type: "adaptive" } | { type: "disabled" } {
-  return thinkingEnabled === false
-    ? { type: "disabled" }
-    : { type: "adaptive" };
+function buildThinkingConfig(): { type: "adaptive" } {
+  return { type: "adaptive" };
 }
 
 function logSdkCliPath(context: string, cliPath?: string): void {
@@ -275,7 +275,7 @@ async function revalidateClaudeModelsCache(cwd?: string): Promise<{ models: Arra
       const queryOptions: Record<string, unknown> = {
         cwd: cwd?.trim() || os.homedir(),
         includePartialMessages: true,
-        thinking: buildThinkingConfig(true),
+        thinking: buildThinkingConfig(),
         settingSources: ["user", "project"],
         pathToClaudeCodeExecutable: cliPath,
         ...fileCheckpointOptions(),
@@ -342,6 +342,8 @@ async function restartSession(
   getMainWindow: () => BrowserWindow | null,
   mcpServersOverride?: McpServerInput[],
   cwdOverride?: string,
+  effortOverride?: StartOptions["effort"],
+  modelOverride?: string,
 ): Promise<{ ok?: boolean; error?: string; restarted?: boolean }> {
   const session = sessions.get(sessionId);
   if (!session?.queryHandle || !session.startOptions) {
@@ -375,7 +377,13 @@ async function restartSession(
     queryHandle: null,
     eventCounter: session.eventCounter,
     pendingPermissions: new Map(),
-    startOptions: { ...opts, cwd, mcpServers },
+    startOptions: {
+      ...opts,
+      cwd,
+      mcpServers,
+      ...(effortOverride ? { effort: effortOverride } : {}),
+      ...(modelOverride ? { model: modelOverride } : {}),
+    },
   };
 
   const canUseTool = (toolName: string, input: unknown, context: { toolUseID: string; suggestions: unknown; decisionReason: string }) => {
@@ -397,7 +405,7 @@ async function restartSession(
   const queryOptions: Record<string, unknown> = {
     cwd,
     includePartialMessages: true,
-    thinking: buildThinkingConfig(opts.thinkingEnabled),
+    thinking: buildThinkingConfig(),
     canUseTool,
     settingSources: ["user", "project"],
     pathToClaudeCodeExecutable: cliPath,
@@ -416,7 +424,10 @@ async function restartSession(
       queryOptions.allowDangerouslySkipPermissions = true;
     }
   }
-  if (opts.model) queryOptions.model = opts.model;
+  if (modelOverride ?? opts.model) queryOptions.model = modelOverride ?? opts.model;
+  if (effortOverride ?? opts.effort) {
+    queryOptions.effort = effortOverride ?? opts.effort;
+  }
 
   if (mcpServers?.length) {
     queryOptions.mcpServers = await buildSdkMcpConfig(mcpServers);
@@ -494,7 +505,7 @@ export function register(getMainWindow: () => BrowserWindow | null): void {
       const queryOptions: Record<string, unknown> = {
         cwd: options.cwd || process.cwd(),
         includePartialMessages: true,
-        thinking: buildThinkingConfig(options.thinkingEnabled),
+        thinking: buildThinkingConfig(),
         canUseTool,
         settingSources: ["user", "project"],
         pathToClaudeCodeExecutable: cliPath,
@@ -527,6 +538,9 @@ export function register(getMainWindow: () => BrowserWindow | null): void {
       if (options.model) {
         queryOptions.model = options.model;
       }
+      if (options.effort) {
+        queryOptions.effort = options.effort;
+      }
 
       if (options.mcpServers?.length) {
         queryOptions.mcpServers = await buildSdkMcpConfig(options.mcpServers);
@@ -666,14 +680,14 @@ export function register(getMainWindow: () => BrowserWindow | null): void {
       return { error: "Reasoning toggle is not supported by this Claude SDK version" };
     }
     try {
-      await session.queryHandle.setMaxThinkingTokens(thinkingEnabled ? null : 0);
+      await session.queryHandle.setMaxThinkingTokens(null);
       if (session.startOptions) {
-        session.startOptions.thinkingEnabled = thinkingEnabled;
+        session.startOptions.thinkingEnabled = true;
       }
-      log("SET_THINKING", `session=${sessionId.slice(0, 8)} thinkingEnabled=${thinkingEnabled}`);
+      log("SET_THINKING", `session=${sessionId.slice(0, 8)} requested=${thinkingEnabled} applied=true`);
       return { ok: true };
     } catch (err) {
-      log("SET_THINKING_ERR", `session=${sessionId.slice(0, 8)} thinkingEnabled=${thinkingEnabled} ${extractErrorMessage(err)}`);
+      log("SET_THINKING_ERR", `session=${sessionId.slice(0, 8)} requested=${thinkingEnabled} ${extractErrorMessage(err)}`);
       return { error: extractErrorMessage(err) };
     }
   });
@@ -831,7 +845,19 @@ export function register(getMainWindow: () => BrowserWindow | null): void {
   });
 
   // Restart the session with a new MCP server list (e.g., after add/remove)
-  ipcMain.handle("claude:restart-session", async (_event, { sessionId, mcpServers, cwd }: { sessionId: string; mcpServers?: McpServerInput[]; cwd?: string }) => {
-    return restartSession(sessionId, getMainWindow, mcpServers, cwd);
+  ipcMain.handle("claude:restart-session", async (_event, {
+    sessionId,
+    mcpServers,
+    cwd,
+    effort,
+    model,
+  }: {
+    sessionId: string;
+    mcpServers?: McpServerInput[];
+    cwd?: string;
+    effort?: StartOptions["effort"];
+    model?: string;
+  }) => {
+    return restartSession(sessionId, getMainWindow, mcpServers, cwd, effort, model);
   });
 }

electron/src/lib/claude-model-cache.ts

@@ -6,6 +6,10 @@ export interface CachedModelInfo {
   value: string;
   displayName: string;
   description: string;
+  supportsEffort?: boolean;
+  supportedEffortLevels?: Array<"low" | "medium" | "high" | "max">;
+  supportsAdaptiveThinking?: boolean;
+  supportsFastMode?: boolean;
 }
 
 interface ClaudeModelsCacheData {
@@ -25,10 +29,22 @@ function normalizeModelInfo(value: unknown): CachedModelInfo | null {
   if (typeof model.value !== "string" || model.value.trim().length === 0) return null;
   const displayName = typeof model.displayName === "string" ? model.displayName : model.value;
   const description = typeof model.description === "string" ? model.description : "";
+  const supportedEffortLevels = Array.isArray(model.supportedEffortLevels)
+    ? model.supportedEffortLevels.filter(
+      (level): level is "low" | "medium" | "high" | "max" =>
+        level === "low" || level === "medium" || level === "high" || level === "max",
+    )
+    : undefined;
   return {
     value: model.value,
     displayName,
     description,
+    ...(typeof model.supportsEffort === "boolean" ? { supportsEffort: model.supportsEffort } : {}),
+    ...(supportedEffortLevels && supportedEffortLevels.length > 0 ? { supportedEffortLevels } : {}),
+    ...(typeof model.supportsAdaptiveThinking === "boolean"
+      ? { supportsAdaptiveThinking: model.supportsAdaptiveThinking }
+      : {}),
+    ...(typeof model.supportsFastMode === "boolean" ? { supportsFastMode: model.supportsFastMode } : {}),
   };
 }
 

electron/src/main.ts

@@ -92,7 +92,7 @@ function createWindow(): void {
     // macOS Tahoe+ with liquid glass
     windowOptions.titleBarStyle = "hidden";
     windowOptions.transparent = true;
-    windowOptions.trafficLightPosition = { x: 16, y: 16 };
+    windowOptions.trafficLightPosition = { x: 19, y: 19 };
   } else if (process.platform === "win32") {
     // Windows: native Electron backgroundMaterial handles DWM mica/acrylic.
     // WebContents is automatically transparent (no transparent: true needed),
@@ -102,7 +102,7 @@ function createWindow(): void {
   } else {
     // macOS without glass / Linux
     windowOptions.titleBarStyle = "hiddenInset";
-    windowOptions.trafficLightPosition = { x: 16, y: 16 };
+    windowOptions.trafficLightPosition = { x: 19, y: 19 };
     windowOptions.backgroundColor = "#18181b";
   }
 

electron/src/preload.ts

@@ -63,8 +63,8 @@ contextBridge.exposeInMainWorld("claude", {
     ipcRenderer.invoke("claude:mcp-reconnect", { sessionId, serverName }),
   revertFiles: (sessionId: string, checkpointId: string) =>
     ipcRenderer.invoke("claude:revert-files", { sessionId, checkpointId }),
-  restartSession: (sessionId: string, mcpServers?: unknown[], cwd?: string) =>
-    ipcRenderer.invoke("claude:restart-session", { sessionId, mcpServers, cwd }),
+  restartSession: (sessionId: string, mcpServers?: unknown[], cwd?: string, effort?: string, model?: string) =>
+    ipcRenderer.invoke("claude:restart-session", { sessionId, mcpServers, cwd, effort, model }),
   readFile: (filePath: string) => ipcRenderer.invoke("file:read", filePath),
   openInEditor: (filePath: string, line?: number, editor?: string) => ipcRenderer.invoke("file:open-in-editor", { filePath, line, editor }),
   openExternal: (url: string) => ipcRenderer.invoke("shell:open-external", url),

package.json

@@ -1,6 +1,6 @@
 {
   "name": "harnss",
-  "version": "0.17.2",
+  "version": "0.17.3",
   "productName": "Harnss",
   "description": "Harness your AI coding agents — one desktop app for Claude Code, Codex, and any ACP agent",
   "author": {

shared/types/engine.ts

@@ -25,6 +25,7 @@ export interface SessionMeta {
   isConnected: boolean;
   sessionInfo: SessionInfo | null;
   totalCost: number;
+  contextUsage: ContextUsage | null;
   isCompacting?: boolean;
 }
 

src/components/AppLayout.tsx

@@ -65,7 +65,7 @@ export function AppLayout() {
     spaceTerminals, activeSpaceTerminals,
     handleToggleTool, handleToolReorder, handleNewChat, handleSend,
     handleModelChange, handlePermissionModeChange, handlePlanModeChange,
-    handleThinkingChange, handleAgentWorktreeChange, handleStop, handleSelectSession,
+    handleClaudeModelEffortChange, handleAgentWorktreeChange, handleStop, handleSelectSession,
     handleSendQueuedNow,
     handleCreateProject, handleImportCCSession, handleNavigateToMessage,
     handleViewTurnChanges, handleCreateSpace, handleEditSpace,
@@ -300,7 +300,9 @@ Link: ${issue.url}`;
   const titlebarOpacity = Math.round(30 + 50 * spaceOpacity); // 30–80%
   const titlebarSurfaceColor =
     `linear-gradient(to bottom, color-mix(in oklab, var(--background) ${titlebarOpacity}%, transparent) 0%, transparent 100%)`;
-  const topFadeBackground = `linear-gradient(to bottom, ${chatSurfaceColor}, transparent)`;
+  const topFadeBackground = isIsland
+    ? `linear-gradient(to bottom, ${chatSurfaceColor}, transparent)`
+    : `linear-gradient(to bottom, ${chatSurfaceColor} 0%, ${chatSurfaceColor} 22%, transparent 100%)`;
   const bottomFadeBackground = `linear-gradient(to top, ${chatSurfaceColor}, transparent)`;
 
   const { activeTools } = settings;
@@ -367,10 +369,13 @@ Link: ${issue.url}`;
             onIslandLayoutChange={settings.setIslandLayout}
             autoGroupTools={settings.autoGroupTools}
             onAutoGroupToolsChange={settings.setAutoGroupTools}
+            autoExpandTools={settings.autoExpandTools}
+            onAutoExpandToolsChange={settings.setAutoExpandTools}
             transparency={settings.transparency}
             onTransparencyChange={settings.setTransparency}
             glassSupported={glassSupported}
             sidebarOpen={sidebar.isOpen}
+            onToggleSidebar={sidebar.toggle}
             onReplayWelcome={handleReplayWelcome}
           />
         )}
@@ -397,7 +402,9 @@ Link: ${issue.url}`;
               {/* Top fade: only visible when chat is scrolled down. Island mode uses dark shadow; flat mode fades content into bg */}
               {/* Island: gradient starts at top-0 (behind header, subtle bleed). Flat: starts at top-10 (right below header) so full gradient is visible and strong. */}
               <div
-                className="pointer-events-none absolute inset-x-0 top-0 z-[5] h-16"
+                className={`pointer-events-none absolute inset-x-0 top-0 z-[5] ${
+                  isIsland ? "h-16" : "h-20"
+                }`}
                 style={{
                   opacity: "calc(var(--chat-fade-strength, 1) * var(--chat-top-progress, 0))",
                   background: topFadeBackground,
@@ -408,6 +415,7 @@ Link: ${issue.url}`;
                 style={{ background: titlebarSurfaceColor }}
               >
                 <ChatHeader
+                  islandLayout={isIsland}
                   sidebarOpen={sidebar.isOpen}
                   isProcessing={manager.isProcessing}
                   model={manager.sessionInfo?.model}
@@ -436,6 +444,7 @@ Link: ${issue.url}`;
                 isProcessing={manager.isProcessing}
                 showThinking={showThinking}
                 autoGroupTools={settings.autoGroupTools}
+                autoExpandTools={settings.autoExpandTools}
                 extraBottomPadding={!!manager.pendingPermission}
                 scrollToMessageId={scrollToMessageId}
                 onScrolledToMessage={() => setScrollToMessageId(undefined)}
@@ -470,11 +479,11 @@ Link: ${issue.url}`;
                     isProcessing={manager.isProcessing}
                     queuedCount={manager.queuedCount}
                     model={settings.model}
-                    thinking={settings.thinking}
+                    claudeEffort={settings.claudeEffort}
                     planMode={settings.planMode}
                     permissionMode={settings.permissionMode}
                     onModelChange={handleModelChange}
-                    onThinkingChange={handleThinkingChange}
+                    onClaudeModelEffortChange={handleClaudeModelEffortChange}
                     onPlanModeChange={handlePlanModeChange}
                     onPermissionModeChange={handlePermissionModeChange}
                     projectPath={activeProjectPath}
@@ -506,16 +515,20 @@ Link: ${issue.url}`;
           ) : (
             <>
               <div
-                className={`chat-titlebar-bg drag-region flex h-12 items-center px-3 ${
-                  !sidebar.isOpen && isMac ? "ps-[78px]" : ""
+                className={`chat-titlebar-bg drag-region flex items-center ${
+                  isIsland ? "h-12 px-3" : "h-[3.25rem] px-4"
+                } ${
+                  !sidebar.isOpen && isMac ? (isIsland ? "ps-[78px]" : "ps-[84px]") : ""
                 }`}
                 style={{ background: titlebarSurfaceColor }}
               >
                 {!sidebar.isOpen && (
                   <Button
                     variant="ghost"
                     size="icon"
-                    className="no-drag h-7 w-7 text-muted-foreground/60 hover:text-foreground"
+                    className={`no-drag h-7 w-7 text-muted-foreground/60 hover:text-foreground ${
+                      isIsland ? "mt-0.5" : ""
+                    }`}
                     onClick={sidebar.toggle}
                   >
                     <PanelLeft className="h-4 w-4" />
@@ -768,6 +781,10 @@ Link: ${issue.url}`;
           onThemeChange={settings.setTheme}
           islandLayout={settings.islandLayout}
           onIslandLayoutChange={settings.setIslandLayout}
+          autoGroupTools={settings.autoGroupTools}
+          onAutoGroupToolsChange={settings.setAutoGroupTools}
+          autoExpandTools={settings.autoExpandTools}
+          onAutoExpandToolsChange={settings.setAutoExpandTools}
           transparency={settings.transparency}
           onTransparencyChange={settings.setTransparency}
           glassSupported={glassSupported}