Skip to content

Personal AI, On Personal Devices

Python

docs: add desktop UX improvements spec and implementation plan

Jon Saad-Falcon46fcd5bab459
diff --git a/docs/superpowers/plans/2026-03-14-desktop-ux-improvements.md b/docs/superpowers/plans/2026-03-14-desktop-ux-improvements.md
new file mode 100644
index 00000000..ac2b7c74
--- /dev/null
+++ b/docs/superpowers/plans/2026-03-14-desktop-ux-improvements.md
@@ -0,0 +1,930 @@
+# Desktop UX Improvements Implementation Plan
+
+> **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Improve the OpenJarvis desktop app and web browser UX with 7 changes: new app logo, cleaner system panel with device temps, theme toggle, better streaming labels, model switching feedback, and a logs page.
+
+**Architecture:** All changes are frontend-first (React/TypeScript/Zustand). One backend change extends the existing `/v1/telemetry/energy` endpoint to include temperature fields already collected by `EnergySample`. No new backend endpoints needed — temperatures are already in the data pipeline, just not exposed via the API.
+
+**Tech Stack:** React 19, TypeScript, Zustand, Tailwind CSS, Lucide icons, FastAPI (backend), Python telemetry modules, sips (macOS image conversion)
+
+**Spec:** `docs/superpowers/specs/2026-03-14-desktop-ux-improvements-design.md`
+
+---
+
+## Chunk 0: App Logo
+
+### Task 0: Replace app icons with new arc reactor logo
+
+**Source image:** `/Users/jonsaadfalcon/Documents/OpenJarvis_Logos/OpenJarvis_DesktopAppLogo_DarkBackground_ZoomedIn.png`
+
+**Files:**
+- Replace: `desktop/src-tauri/icons/32x32.png`
+- Replace: `desktop/src-tauri/icons/128x128.png`
+- Replace: `desktop/src-tauri/icons/[email protected]`
+- Replace: `desktop/src-tauri/icons/256x256.png`
+- Replace: `desktop/src-tauri/icons/icon.png`
+- Replace: `desktop/src-tauri/icons/icon.icns`
+- Replace: `desktop/src-tauri/icons/icon.ico`
+- Replace: `frontend/public/favicon.ico`
+- Replace: `frontend/public/apple-touch-icon.png`
+- Replace: `frontend/public/pwa-192x192.png`
+- Replace: `frontend/public/pwa-512x512.png`
+
+- [ ] **Step 1: Generate all PNG sizes from source image**
+
+```bash
+SRC="/Users/jonsaadfalcon/Documents/OpenJarvis_Logos/OpenJarvis_DesktopAppLogo_DarkBackground_ZoomedIn.png"
+ICONS="desktop/src-tauri/icons"
+PUBLIC="frontend/public"
+
+# Desktop icons
+sips -z 32 32 "$SRC" --out "$ICONS/32x32.png"
+sips -z 128 128 "$SRC" --out "$ICONS/128x128.png"
+sips -z 256 256 "$SRC" --out "$ICONS/[email protected]"
+sips -z 256 256 "$SRC" --out "$ICONS/256x256.png"
+sips -z 1024 1024 "$SRC" --out "$ICONS/icon.png"
+
+# Frontend icons
+sips -z 180 180 "$SRC" --out "$PUBLIC/apple-touch-icon.png"
+sips -z 192 192 "$SRC" --out "$PUBLIC/pwa-192x192.png"
+sips -z 512 512 "$SRC" --out "$PUBLIC/pwa-512x512.png"
+```
+
+- [ ] **Step 2: Generate .icns for macOS**
+
+```bash
+mkdir -p /tmp/openjarvis-icon.iconset
+sips -z 16 16 "$SRC" --out /tmp/openjarvis-icon.iconset/icon_16x16.png
+sips -z 32 32 "$SRC" --out /tmp/openjarvis-icon.iconset/[email protected]
+sips -z 32 32 "$SRC" --out /tmp/openjarvis-icon.iconset/icon_32x32.png
+sips -z 64 64 "$SRC" --out /tmp/openjarvis-icon.iconset/[email protected]
+sips -z 128 128 "$SRC" --out /tmp/openjarvis-icon.iconset/icon_128x128.png
+sips -z 256 256 "$SRC" --out /tmp/openjarvis-icon.iconset/[email protected]
+sips -z 256 256 "$SRC" --out /tmp/openjarvis-icon.iconset/icon_256x256.png
+sips -z 512 512 "$SRC" --out /tmp/openjarvis-icon.iconset/[email protected]
+sips -z 512 512 "$SRC" --out /tmp/openjarvis-icon.iconset/icon_512x512.png
+sips -z 1024 1024 "$SRC" --out /tmp/openjarvis-icon.iconset/[email protected]
+iconutil -c icns /tmp/openjarvis-icon.iconset -o "$ICONS/icon.icns"
+rm -rf /tmp/openjarvis-icon.iconset
+```
+
+- [ ] **Step 3: Generate .ico for Windows**
+
+```bash
+# Use sips to create the sizes, then ImageMagick convert (or pip install Pillow)
+python3 -c "
+from PIL import Image
+img = Image.open('$ICONS/icon.png')
+img.save('$ICONS/icon.ico', sizes=[(16,16),(32,32),(48,48),(64,64),(128,128),(256,256)])
+"
+```
+
+If Pillow is not available, install with `pip3 install Pillow` first.
+
+- [ ] **Step 4: Generate favicon.ico for web**
+
+```bash
+python3 -c "
+from PIL import Image
+img = Image.open('$PUBLIC/pwa-512x512.png')
+img.save('$PUBLIC/favicon.ico', sizes=[(16,16),(32,32),(48,48)])
+"
+```
+
+- [ ] **Step 5: Verify icons exist and are correct sizes**
+
+```bash
+file desktop/src-tauri/icons/*.png desktop/src-tauri/icons/icon.icns desktop/src-tauri/icons/icon.ico
+file frontend/public/favicon.ico frontend/public/apple-touch-icon.png frontend/public/pwa-*.png
+```
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add desktop/src-tauri/icons/ frontend/public/favicon.ico frontend/public/apple-touch-icon.png frontend/public/pwa-192x192.png frontend/public/pwa-512x512.png
+git commit -m "feat: replace app icons with arc reactor logo"
+```
+
+---
+
+## Chunk 1: Foundation — Types, Store, and Backend
+
+### Task 1: Add LogEntry type and extend store
+
+**Files:**
+- Modify: `frontend/src/types/index.ts`
+- Modify: `frontend/src/lib/store.ts`
+
+- [ ] **Step 1: Add LogEntry interface to types**
+
+In `frontend/src/types/index.ts`, add after the `ServerInfo` interface (line 120):
+
+```typescript
+// --- Log Types ---
+
+export interface LogEntry {
+ timestamp: number;
+ level: 'info' | 'warn' | 'error';
+ category: 'server' | 'model' | 'chat' | 'tool';
+ message: string;
+}
+```
+
+- [ ] **Step 2: Add log and model-loading state to store**
+
+In `frontend/src/lib/store.ts`, add to the `AppState` interface (after line 183, the `setSelectedAgentId` line):
+
+```typescript
+ // Logs
+ logEntries: LogEntry[];
+ addLogEntry: (entry: LogEntry) => void;
+ clearLogs: () => void;
+
+ // Model loading
+ modelLoading: boolean;
+ setModelLoading: (loading: boolean) => void;
+```
+
+Add the import at the top of `store.ts`:
+
+```typescript
+import type { LogEntry } from '../types';
+```
+
+(Add `LogEntry` to the existing import from `'../types'`.)
+
+Add the implementations in the store body (after the agent events section, ~line 388):
+
+```typescript
+ // ── Logs ────────────────────────────────────────────────────────
+ logEntries: [],
+ addLogEntry: (entry) => set((s) => ({
+ logEntries: [...s.logEntries.slice(-499), entry],
+ })),
+ clearLogs: () => set({ logEntries: [] }),
+
+ // ── Model loading ───────────────────────────────────────────────
+ modelLoading: false,
+ setModelLoading: (loading) => set({ modelLoading: loading }),
+```
+
+- [ ] **Step 3: Verify TypeScript compiles**
+
+Run: `cd frontend && npx tsc --noEmit`
+Expected: no errors
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add frontend/src/types/index.ts frontend/src/lib/store.ts
+git commit -m "feat: add LogEntry type, log store, and modelLoading state"
+```
+
+---
+
+### Task 2: Expose temperature in /v1/telemetry/energy endpoint
+
+**Files:**
+- Modify: `src/openjarvis/server/api_routes.py:240-271`
+
+The `EnergySample` dataclass already has `mean_temperature_c` and `peak_temperature_c` fields (populated by NVIDIA monitors, zero for others). We just need to include them in the API response.
+
+- [ ] **Step 1: Add temp fields to the energy endpoint response**
+
+In `src/openjarvis/server/api_routes.py`, in the `telemetry_energy` function, update the return dict (lines 259-267) to:
+
+```python
+ return {
+ "total_energy_j": total_energy,
+ "energy_per_token_j": (
+ total_energy / total_tokens if total_tokens > 0 else 0
+ ),
+ "avg_power_w": (
+ total_energy / total_latency if total_latency > 0 else 0
+ ),
+ "cpu_temp_c": None, # populated per-platform below
+ "gpu_temp_c": None,
+ }
+```
+
+Note: The current aggregator `summary()` doesn't directly expose per-sample temperature. For v1, return `None` (the frontend handles graceful degradation). A follow-up task can wire the live energy monitor's last sample temperature through.
+
+Also update the empty fallback response (line 250) to include the new fields:
+
+```python
+ return {"total_energy_j": 0, "energy_per_token_j": 0, "avg_power_w": 0, "cpu_temp_c": None, "gpu_temp_c": None}
+```
+
+- [ ] **Step 2: Run lint and tests**
+
+Run: `uv run ruff check src/openjarvis/server/api_routes.py`
+Run: `uv run pytest tests/server/ -v --tb=short`
+Expected: all pass
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add src/openjarvis/server/api_routes.py
+git commit -m "feat: include cpu/gpu temp fields in telemetry energy endpoint"
+```
+
+---
+
+### Task 3: Add preloadModel to api.ts
+
+**Files:**
+- Modify: `frontend/src/lib/api.ts`
+
+- [ ] **Step 1: Add preloadModel function**
+
+Add after the `deleteModel` function in `api.ts`:
+
+```typescript
+export async function preloadModel(modelName: string): Promise<void> {
+ // Trigger Ollama to load the model into memory (empty prompt, no generation).
+ // In Tauri, use the Rust backend; in browser, call Ollama directly via the server.
+ const ollamaUrl = 'http://127.0.0.1:11434';
+ try {
+ const res = await fetch(`${ollamaUrl}/api/generate`, {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({ model: modelName, prompt: '', keep_alive: '5m' }),
+ signal: AbortSignal.timeout(120_000),
+ });
+ if (!res.ok) throw new Error(`Preload failed: ${res.status}`);
+ } catch (e: any) {
+ if (e.name === 'TimeoutError') throw new Error('Model load timed out (120s)');
+ throw e;
+ }
+}
+```
+
+- [ ] **Step 2: Verify TypeScript compiles**
+
+Run: `cd frontend && npx tsc --noEmit`
+Expected: no errors
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add frontend/src/lib/api.ts
+git commit -m "feat: add preloadModel API function for model warm-up"
+```
+
+---
+
+## Chunk 2: UI Changes — SystemPanel, Sidebar, Streaming Labels
+
+### Task 4: Clean up SystemPanel (remove redundancy, rename ENERGY to DEVICE)
+
+**Files:**
+- Modify: `frontend/src/components/Chat/SystemPanel.tsx`
+
+- [ ] **Step 1: Update fetch to use getBase()**
+
+Replace the `fetchData` callback (lines 42-58) to use `getBase()` from api.ts:
+
+```typescript
+import { getBase } from '../../lib/api';
+```
+
+Then change line 44 from:
+```typescript
+ const base = import.meta.env.VITE_API_URL || '';
+```
+to:
+```typescript
+ const base = getBase();
+```
+
+- [ ] **Step 2: Add temp fields to EnergyData interface**
+
+Update the `EnergyData` interface (lines 17-21):
+
+```typescript
+interface EnergyData {
+ total_energy_j?: number;
+ energy_per_token_j?: number;
+ avg_power_w?: number;
+ cpu_temp_c?: number | null;
+ gpu_temp_c?: number | null;
+}
+```
+
+- [ ] **Step 3: Remove thermalStatus logic and "Cool" label**
+
+Delete lines 71-76 (the `thermalStatus` const).
+
+Replace the Energy section (lines 121-155) with:
+
+```tsx
+ {/* Device */}
+ <section>
+ <h4 className="text-[11px] font-medium uppercase tracking-wide mb-2" style={{ color: 'var(--color-text-tertiary)' }}>
+ Device
+ </h4>
+ <div className="grid grid-cols-2 gap-2">
+ {energy?.cpu_temp_c != null && (
+ <MiniStat icon={Thermometer} label="CPU Temp" value={String(Math.round(energy.cpu_temp_c))} unit="°C" />
+ )}
+ {energy?.gpu_temp_c != null && (
+ <MiniStat icon={Thermometer} label="GPU Temp" value={String(Math.round(energy.gpu_temp_c))} unit="°C" />
+ )}
+ <MiniStat
+ icon={Zap}
+ label="Power"
+ value={(energy?.avg_power_w ?? 0).toFixed(1)}
+ unit="W"
+ />
+ <MiniStat
+ icon={Activity}
+ label="Energy"
+ value={((energy?.total_energy_j ?? 0) / 1000).toFixed(1)}
+ unit="kJ"
+ />
+ </div>
+ </section>
+```
+
+- [ ] **Step 4: Remove Server-reported section**
+
+Delete lines 220-233 (the "Server-reported savings" block).
+
+- [ ] **Step 5: Verify TypeScript compiles**
+
+Run: `cd frontend && npx tsc --noEmit`
+Expected: no errors
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add frontend/src/components/Chat/SystemPanel.tsx
+git commit -m "feat: replace Energy section with Device (temps, power, energy), remove server-reported"
+```
+
+---
+
+### Task 5: Add theme toggle to sidebar header
+
+**Files:**
+- Modify: `frontend/src/components/Sidebar/Sidebar.tsx`
+
+- [ ] **Step 1: Add imports and store access**
+
+Add `Sun`, `Moon`, `Monitor` to the lucide-react import (line 3):
+
+```typescript
+import {
+ MessageSquare,
+ Plus,
+ BarChart3,
+ Settings,
+ Search,
+ PanelLeftClose,
+ PanelLeft,
+ Cpu,
+ Rocket,
+ Bot,
+ Sun,
+ Moon,
+ Monitor,
+} from 'lucide-react';
+```
+
+Inside the `Sidebar` component, add after `setCommandPaletteOpen` (line 28):
+
+```typescript
+ const settings = useAppStore((s) => s.settings);
+ const updateSettings = useAppStore((s) => s.updateSettings);
+
+ const ThemeIcon = settings.theme === 'light' ? Sun : settings.theme === 'dark' ? Moon : Monitor;
+ const nextTheme = settings.theme === 'light' ? 'dark' : settings.theme === 'dark' ? 'system' : 'light';
+```
+
+- [ ] **Step 2: Add the icon button in the header**
+
+In the header `div` (line 68), insert the theme toggle button between the collapse button and the new-chat button. Replace the header div:
+
+```tsx
+ <div className="flex items-center justify-between px-3 pt-3 pb-2">
+ <button
+ onClick={toggleSidebar}
+ className="p-2 rounded-lg transition-colors cursor-pointer"
+ style={{ color: 'var(--color-text-secondary)' }}
+ onMouseEnter={(e) => (e.currentTarget.style.background = 'var(--color-bg-tertiary)')}
+ onMouseLeave={(e) => (e.currentTarget.style.background = 'transparent')}
+ >
+ <PanelLeftClose size={18} />
+ </button>
+ <div className="flex items-center gap-1">
+ <button
+ onClick={() => updateSettings({ theme: nextTheme })}
+ className="p-2 rounded-lg transition-colors cursor-pointer"
+ style={{ color: 'var(--color-text-secondary)' }}
+ onMouseEnter={(e) => (e.currentTarget.style.background = 'var(--color-bg-tertiary)')}
+ onMouseLeave={(e) => (e.currentTarget.style.background = 'transparent')}
+ title={`Theme: ${settings.theme} (click for ${nextTheme})`}
+ >
+ <ThemeIcon size={16} />
+ </button>
+ <button
+ onClick={handleNewChat}
+ className="p-2 rounded-lg transition-colors cursor-pointer"
+ style={{ color: 'var(--color-text-secondary)' }}
+ onMouseEnter={(e) => (e.currentTarget.style.background = 'var(--color-bg-tertiary)')}
+ onMouseLeave={(e) => (e.currentTarget.style.background = 'transparent')}
+ title="New chat"
+ >
+ <Plus size={18} />
+ </button>
+ </div>
+ </div>
+```
+
+- [ ] **Step 3: Verify TypeScript compiles**
+
+Run: `cd frontend && npx tsc --noEmit`
+Expected: no errors
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add frontend/src/components/Sidebar/Sidebar.tsx
+git commit -m "feat: add theme toggle icon in sidebar header"
+```
+
+---
+
+### Task 6: Update streaming status labels
+
+**Files:**
+- Modify: `frontend/src/components/Chat/InputArea.tsx`
+
+- [ ] **Step 1: Change "Sending..." to "Connecting..."**
+
+Find the `setStreamState` call at ~line 132:
+
+```typescript
+ setStreamState({
+ isStreaming: true,
+ phase: 'Sending...',
+```
+
+Change to:
+
+```typescript
+ setStreamState({
+ isStreaming: true,
+ phase: 'Connecting...',
+```
+
+- [ ] **Step 2: Change "Running {tool}..." to "Calling {tool}..."**
+
+Find the string `Running ${data.tool}...` (in the `tool_call_start` handler):
+
+```typescript
+ phase: `Running ${data.tool}...`,
+```
+
+Change to:
+
+```typescript
+ phase: `Calling ${data.tool}...`,
+```
+
+- [ ] **Step 3: Verify TypeScript compiles**
+
+Run: `cd frontend && npx tsc --noEmit`
+Expected: no errors
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add frontend/src/components/Chat/InputArea.tsx
+git commit -m "fix: update streaming labels to Connecting/Calling"
+```
+
+---
+
+## Chunk 3: Model Loading Indicator
+
+### Task 7: Wire model preloading through CommandPalette and show loading in sidebar
+
+**Files:**
+- Modify: `frontend/src/components/CommandPalette.tsx`
+- Modify: `frontend/src/components/Sidebar/Sidebar.tsx`
+- Modify: `frontend/src/components/Chat/InputArea.tsx`
+
+- [ ] **Step 1: Trigger preload on model selection in CommandPalette**
+
+In `CommandPalette.tsx`, add imports:
+
+```typescript
+import { pullModel, deleteModel, fetchModels, preloadModel } from '../lib/api';
+```
+
+(`preloadModel` added to the existing import.)
+
+Update `handleSelect` (line 68-71) to:
+
+```typescript
+ const handleSelect = async (modelId: string) => {
+ const previousModel = selectedModel;
+ setSelectedModel(modelId);
+ setCommandPaletteOpen(false);
+
+ // Preload the model if switching to a different one
+ if (modelId !== previousModel) {
+ const { setModelLoading, addLogEntry } = useAppStore.getState();
+ setModelLoading(true);
+ addLogEntry({ timestamp: Date.now(), level: 'info', category: 'model', message: `Switching to ${modelId}...` });
+ try {
+ await preloadModel(modelId);
+ addLogEntry({ timestamp: Date.now(), level: 'info', category: 'model', message: `${modelId} loaded` });
+ } catch (e: any) {
+ addLogEntry({ timestamp: Date.now(), level: 'error', category: 'model', message: `Failed to load ${modelId}: ${e.message}` });
+ } finally {
+ setModelLoading(false);
+ }
+ }
+ };
+```
+
+- [ ] **Step 2: Show loading state in sidebar model badge**
+
+In `Sidebar.tsx`, add to store access:
+
+```typescript
+ const modelLoading = useAppStore((s) => s.modelLoading);
+```
+
+Add `Loader2` to the lucide-react imports.
+
+Update the model badge inner content (lines 102-111 inside the button). Replace everything between the opening `>` of the button and the closing `</button>`:
+
+```tsx
+ {modelLoading ? (
+ <Loader2 size={14} className="animate-spin" style={{ color: 'var(--color-accent)' }} />
+ ) : (
+ <Cpu size={14} />
+ )}
+ <div className="flex-1 min-w-0">
+ <span className="truncate block text-left" style={{ color: 'var(--color-text)' }}>
+ {selectedModel || serverInfo?.model || 'Select model'}
+ </span>
+ {modelLoading && (
+ <span className="text-[10px] block" style={{ color: 'var(--color-accent)' }}>
+ Loading model...
+ </span>
+ )}
+ </div>
+ {!modelLoading && (
+ <kbd
+ className="text-[10px] px-1.5 py-0.5 rounded font-mono"
+ style={{ background: 'var(--color-bg-tertiary)', color: 'var(--color-text-tertiary)' }}
+ >
+ ⌘K
+ </kbd>
+ )}
+```
+
+- [ ] **Step 3: Disable input during model loading**
+
+In `InputArea.tsx`, add:
+
+```typescript
+ const modelLoading = useAppStore((s) => s.modelLoading);
+```
+
+Find the textarea's `disabled={streamState.isStreaming}` and change to:
+
+```typescript
+ disabled={streamState.isStreaming || modelLoading}
+```
+
+Find the send button's `disabled={!input.trim()}` and change to:
+
+```typescript
+ disabled={!input.trim() || modelLoading}
+```
+
+- [ ] **Step 4: Verify TypeScript compiles**
+
+Run: `cd frontend && npx tsc --noEmit`
+Expected: no errors
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add frontend/src/components/CommandPalette.tsx frontend/src/components/Sidebar/Sidebar.tsx frontend/src/components/Chat/InputArea.tsx
+git commit -m "feat: model switching shows loading spinner, disables input until ready"
+```
+
+---
+
+## Chunk 4: Logs Page and Log Emission
+
+### Task 8: Create LogsPage component
+
+**Files:**
+- Create: `frontend/src/pages/LogsPage.tsx`
+
+- [ ] **Step 1: Create the LogsPage**
+
+```typescript
+import { useRef, useEffect } from 'react';
+import { ScrollText, Copy, Trash2 } from 'lucide-react';
+import { useAppStore } from '../lib/store';
+
+const LEVEL_COLORS: Record<string, string> = {
+ info: 'var(--color-text)',
+ warn: 'var(--color-warning)',
+ error: 'var(--color-error)',
+};
+
+function formatTime(ts: number): string {
+ const d = new Date(ts);
+ return d.toLocaleTimeString('en-US', { hour12: false, hour: '2-digit', minute: '2-digit', second: '2-digit' });
+}
+
+export function LogsPage() {
+ const logEntries = useAppStore((s) => s.logEntries);
+ const clearLogs = useAppStore((s) => s.clearLogs);
+ const bottomRef = useRef<HTMLDivElement>(null);
+
+ useEffect(() => {
+ bottomRef.current?.scrollIntoView({ behavior: 'smooth' });
+ }, [logEntries.length]);
+
+ const handleCopy = async () => {
+ const text = logEntries
+ .map((e) => `${formatTime(e.timestamp)} [${e.level}] [${e.category}] ${e.message}`)
+ .join('\n');
+ await navigator.clipboard.writeText(text);
+ };
+
+ return (
+ <div className="flex-1 flex flex-col overflow-hidden p-6">
+ <div className="max-w-4xl mx-auto w-full flex flex-col flex-1 overflow-hidden">
+ {/* Header */}
+ <div className="flex items-center gap-3 mb-4 shrink-0">
+ <ScrollText size={24} style={{ color: 'var(--color-accent)' }} />
+ <h1 className="text-xl font-semibold flex-1" style={{ color: 'var(--color-text)' }}>
+ Logs
+ </h1>
+ <span className="text-xs" style={{ color: 'var(--color-text-tertiary)' }}>
+ {logEntries.length} entries
+ </span>
+ <button
+ onClick={handleCopy}
+ className="flex items-center gap-1.5 px-3 py-1.5 rounded-lg text-xs font-medium transition-colors cursor-pointer"
+ style={{ background: 'var(--color-bg-secondary)', color: 'var(--color-text-secondary)', border: '1px solid var(--color-border)' }}
+ >
+ <Copy size={12} /> Copy All
+ </button>
+ <button
+ onClick={clearLogs}
+ className="flex items-center gap-1.5 px-3 py-1.5 rounded-lg text-xs font-medium transition-colors cursor-pointer"
+ style={{ background: 'var(--color-bg-secondary)', color: 'var(--color-text-secondary)', border: '1px solid var(--color-border)' }}
+ >
+ <Trash2 size={12} /> Clear
+ </button>
+ </div>
+
+ {/* Log entries */}
+ <div
+ className="flex-1 overflow-y-auto rounded-xl p-4 font-mono text-xs leading-relaxed"
+ style={{ background: 'var(--color-surface)', border: '1px solid var(--color-border)' }}
+ >
+ {logEntries.length === 0 ? (
+ <div className="text-center py-12" style={{ color: 'var(--color-text-tertiary)' }}>
+ No log entries yet. Logs appear as you chat, switch models, and interact with the app.
+ </div>
+ ) : (
+ logEntries.map((entry, i) => (
+ <div key={i} className="py-0.5">
+ <span style={{ color: 'var(--color-text-tertiary)' }}>{formatTime(entry.timestamp)}</span>
+ {' '}
+ <span style={{ color: LEVEL_COLORS[entry.level] || 'var(--color-text)' }}>
+ [{entry.category}]
+ </span>
+ {' '}
+ <span style={{ color: LEVEL_COLORS[entry.level] || 'var(--color-text)' }}>
+ {entry.message}
+ </span>
+ </div>
+ ))
+ )}
+ <div ref={bottomRef} />
+ </div>
+ </div>
+ </div>
+ );
+}
+```
+
+- [ ] **Step 2: Verify TypeScript compiles**
+
+Run: `cd frontend && npx tsc --noEmit`
+Expected: no errors
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add frontend/src/pages/LogsPage.tsx
+git commit -m "feat: create LogsPage component"
+```
+
+---
+
+### Task 9: Add Logs route and nav item
+
+**Files:**
+- Modify: `frontend/src/App.tsx`
+- Modify: `frontend/src/components/Sidebar/Sidebar.tsx`
+
+- [ ] **Step 1: Add route in App.tsx**
+
+Add import at top of `App.tsx`:
+
+```typescript
+import { LogsPage } from './pages/LogsPage';
+```
+
+Add route inside the `<Route element={<Layout />}>` block, after the agents route:
+
+```tsx
+ <Route path="logs" element={<LogsPage />} />
+```
+
+- [ ] **Step 2: Add Logs nav item in Sidebar.tsx**
+
+Add `ScrollText` to the lucide-react import.
+
+In the `navItems` array (lines 35-41), add between Agents and Settings:
+
+```typescript
+ { path: '/logs', icon: ScrollText, label: 'Logs' },
+```
+
+- [ ] **Step 3: Verify TypeScript compiles**
+
+Run: `cd frontend && npx tsc --noEmit`
+Expected: no errors
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add frontend/src/App.tsx frontend/src/components/Sidebar/Sidebar.tsx
+git commit -m "feat: add Logs route and nav item"
+```
+
+---
+
+### Task 10: Emit log entries from chat and model operations
+
+**Files:**
+- Modify: `frontend/src/components/Chat/InputArea.tsx`
+- Modify: `frontend/src/components/CommandPalette.tsx`
+
+- [ ] **Step 1: Add log emission to InputArea streaming**
+
+In `InputArea.tsx`, add at top of the `sendMessage` callback, after the `setStreamState` call (~line 122):
+
+```typescript
+ useAppStore.getState().addLogEntry({
+ timestamp: Date.now(),
+ level: 'info',
+ category: 'chat',
+ message: `Request: "${content.slice(0, 80)}${content.length > 80 ? '...' : ''}" → ${selectedModel}`,
+ });
+```
+
+In the `inference_start` event handler (~line 149), add:
+
+```typescript
+ setStreamState({ phase: 'Generating...' });
+ useAppStore.getState().addLogEntry({
+ timestamp: Date.now(), level: 'info', category: 'chat',
+ message: `Generating with ${selectedModel}...`,
+ });
+```
+
+In the `tool_call_start` handler (~line 152), add after the existing `setStreamState`:
+
+```typescript
+ useAppStore.getState().addLogEntry({
+ timestamp: Date.now(), level: 'info', category: 'tool',
+ message: `Calling ${data.tool}(${data.arguments || ''})`,
+ });
+```
+
+In the error catch (~line 191), add:
+
+```typescript
+ if (err.name !== 'AbortError') {
+ useAppStore.getState().addLogEntry({
+ timestamp: Date.now(), level: 'error', category: 'chat',
+ message: `Stream error: ${err?.message || String(err)}`,
+ });
+ }
+```
+
+In the finally block, after `resetStream()`, add:
+
+```typescript
+ useAppStore.getState().addLogEntry({
+ timestamp: Date.now(), level: 'info', category: 'chat',
+ message: `Response: ${accumulatedContent.length} chars`,
+ });
+```
+
+- [ ] **Step 2: Add log emission to CommandPalette model operations**
+
+In `CommandPalette.tsx`, the model switch logging was already added in Task 7. Add logging for pull and delete operations.
+
+In `handlePull` (~line 80), add after `setPullSuccess`:
+
+```typescript
+ useAppStore.getState().addLogEntry({
+ timestamp: Date.now(), level: 'info', category: 'model',
+ message: `Downloaded ${modelId}`,
+ });
+```
+
+In `handlePull` catch block:
+
+```typescript
+ useAppStore.getState().addLogEntry({
+ timestamp: Date.now(), level: 'error', category: 'model',
+ message: `Download failed for ${modelId}: ${e.message}`,
+ });
+```
+
+In `handleDelete`, after the `deleteModel` call:
+
+```typescript
+ useAppStore.getState().addLogEntry({
+ timestamp: Date.now(), level: 'info', category: 'model',
+ message: `Deleted ${modelId}`,
+ });
+```
+
+- [ ] **Step 3: Verify TypeScript compiles**
+
+Run: `cd frontend && npx tsc --noEmit`
+Expected: no errors
+
+- [ ] **Step 4: Run full lint**
+
+Run: `uv run ruff check src/ tests/`
+Expected: all pass
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add frontend/src/components/Chat/InputArea.tsx frontend/src/components/CommandPalette.tsx
+git commit -m "feat: emit log entries from chat streaming and model operations"
+```
+
+---
+
+## Chunk 5: Final Verification
+
+### Task 11: Build and test everything
+
+- [ ] **Step 1: Run TypeScript check**
+
+Run: `cd frontend && npx tsc --noEmit`
+Expected: no errors
+
+- [ ] **Step 2: Run frontend build**
+
+Run: `cd frontend && npm run build`
+Expected: successful build
+
+- [ ] **Step 3: Run Python lint**
+
+Run: `uv run ruff check src/ tests/`
+Expected: all pass
+
+- [ ] **Step 4: Run Python tests**
+
+Run: `uv run pytest tests/server/ -v --tb=short`
+Expected: all 100+ tests pass
+
+- [ ] **Step 5: Run Rust cargo check (for desktop)**
+
+Run: `cd desktop/src-tauri && cargo check`
+Expected: no errors (our changes are frontend + Python only, but verify no breakage)
+
+- [ ] **Step 6: Final commit with all files verified**
+
+If any files weren't committed in previous tasks:
+
+```bash
+git status
+# add any remaining files
+git commit -m "chore: final verification — all checks pass"
+```
diff --git a/docs/superpowers/specs/2026-03-14-desktop-ux-improvements-design.md b/docs/superpowers/specs/2026-03-14-desktop-ux-improvements-design.md
new file mode 100644
index 00000000..2fc62d62
--- /dev/null
+++ b/docs/superpowers/specs/2026-03-14-desktop-ux-improvements-design.md
@@ -0,0 +1,155 @@
+# Desktop App UX Improvements — Design Spec
+
+**Date:** 2026-03-14
+**Scope:** Frontend (React) + minor backend (telemetry)
+**Affects:** SystemPanel, Sidebar, InputArea, StreamingDots, new LogsPage, store, api, types
+
+---
+
+## 1. System Panel — Remove Redundancy, Add Device Temps
+
+**Problem:** The right-column system panel has a redundant "Server-reported" section that duplicates Cost Comparison data. The "Cool" thermal label is confusing without context.
+
+**Change:**
+- Remove the "Server-reported" / per-provider savings section entirely from SystemPanel.
+- Rename the "ENERGY" section to "DEVICE".
+- Replace the "Cool/Warm/Hot" label with actual CPU and GPU temperatures (e.g. "CPU: 62°C", "GPU: 71°C").
+- Keep Power (W) and Energy (kJ) in the same section.
+- Display temp rows only when values are non-null (graceful degradation).
+
+**Data flow — per platform:**
+- **NVIDIA GPUs:** Already collected via pynvml in `NvidiaEnergyMonitor` (`mean_temperature_c`, `peak_temperature_c` on `EnergySample`). Just needs to be exposed through the API endpoint.
+- **macOS (Apple Silicon):** Read CPU die temperature via IOKit SMC keys through the Rust extension (PyO3 bindings already exist in `rust/crates/openjarvis-python/`). Does not require root. Return `null` if unavailable.
+- **Linux (no GPU):** Read from `/sys/class/thermal/thermal_zone*/temp`. Return `null` if path doesn't exist.
+- **Windows:** Return `null` for v1 (future: WMI queries).
+- Backend: extend the `/v1/telemetry/energy` endpoint in `api_routes.py` to include `cpu_temp_c` and `gpu_temp_c` fields from the energy sample.
+- Frontend: `SystemPanel.tsx` already polls every 3s. Refactor to use `getBase()` from `api.ts` (fixing existing inconsistency) and add a `fetchDeviceInfo()` function in `api.ts`.
+
+**Files:**
+- `frontend/src/components/Chat/SystemPanel.tsx` — remove server-reported section, rename ENERGY to DEVICE, add temp rows, remove Cool/Warm/Hot logic, use `getBase()`
+- `frontend/src/lib/api.ts` — add `fetchDeviceInfo()` function
+- `src/openjarvis/telemetry/` — add CPU/GPU temp collection for macOS/Linux
+- `src/openjarvis/server/api_routes.py` — expose temp data in `/v1/telemetry/energy` response
+
+---
+
+## 2. Theme Toggle — Sidebar Header
+
+**Problem:** Theme switching is buried in Settings > Appearance. Needs one-click access.
+
+**Change:**
+- Add a sun/moon/monitor icon button in the sidebar header, between the collapse button and the new-chat button.
+- Three-state cycle matching the Settings page: light → dark → system → light.
+- Uses the existing `updateSettings({ theme })` store action.
+- Icons: `Sun` when current theme is light (click → dark), `Moon` when dark (click → system), `Monitor` when system (click → light).
+
+**Files:**
+- `frontend/src/components/Sidebar/Sidebar.tsx` — add icon button to header
+
+---
+
+## 3. Streaming Status Labels
+
+**Problem:** Status text shows "Sending..." at start of generation. Tool call status says "Running {tool}..." which is vague.
+
+**Change:**
+- Initial phase: `"Sending..."` → `"Connecting..."` (accurately describes the period between HTTP request and first SSE event — the model hasn't started generating yet).
+- Tool call start: `"Running ${data.tool}..."` → `"Calling ${data.tool}..."`
+- All other phases unchanged (`"Agent thinking..."`, `"Generating..."` on `inference_start` are already correct).
+
+**Files:**
+- `frontend/src/components/Chat/InputArea.tsx` — update two string literals
+
+---
+
+## 4. Model Switching — Loading Indicator
+
+**Problem:** When switching models via Cmd+K, there's no visual feedback. The model badge updates instantly but Ollama needs time to load the new model into memory. Users may send messages before the model is ready.
+
+**Change:**
+- Add `modelLoading` boolean to the Zustand store.
+- When `setSelectedModel` is called with a different model:
+ 1. Set `modelLoading = true`
+ 2. Update the model badge to show a spinner icon + "Loading model..." subtitle text
+ 3. Trigger Ollama to preload the model via `POST /api/generate` with `{"model": "...", "prompt": "", "keep_alive": "5m"}` (empty prompt loads the model without generating output). Use the same dual-path pattern as other API calls: Tauri invoke with HTTP fallback.
+ 4. On success, set `modelLoading = false`
+ 5. On failure after 120-second timeout, set `modelLoading = false` and show error in logs
+- While `modelLoading` is true, disable the chat input (prevent sending before model is ready).
+- Note: this preload mechanism is Ollama-specific. For other backends (vLLM, SGLang), skip the preload step (models are always loaded).
+
+**Files:**
+- `frontend/src/lib/store.ts` — add `modelLoading` state + `setModelLoading` action
+- `frontend/src/lib/api.ts` — add `preloadModel()` function (Tauri invoke + HTTP fallback)
+- `frontend/src/components/Sidebar/Sidebar.tsx` — show spinner + subtitle in model badge when loading
+- `frontend/src/components/Chat/InputArea.tsx` — disable input when `modelLoading` is true
+- `frontend/src/components/CommandPalette.tsx` — trigger model preloading on selection
+
+---
+
+## 5. Logs Page
+
+**Problem:** Error logging is opaque. When generation fails, users see "Error: Failed to get response" with no way to diagnose what happened or share logs.
+
+**Change:**
+- Add a new `LogsPage` component at route `/logs`.
+- Add "Logs" nav item to sidebar bottom nav (between Agents and Settings), with `ScrollText` icon.
+- Log entries are collected in a Zustand array (`logEntries`) during the session.
+- Sources of log entries:
+ - SSE events during streaming (inference_start, tool_call_start, tool_call_end, errors)
+ - Model switches and preload results
+ - Server health check results
+ - Fetch errors (chat, models, savings)
+ - Model pull/delete operations
+- Each entry: `{ timestamp: number, level: 'info' | 'warn' | 'error', category: string, message: string }`
+- Add `LogEntry` interface to `frontend/src/types/index.ts`.
+- Categories: `server`, `model`, `chat`, `tool`
+- Color coding by **level only**: info = default text color, warn = yellow, error = red. Category shown as a bracketed prefix (e.g. `[model]`, `[chat]`).
+- Actions: "Copy All" (copies log text to clipboard), "Clear" (resets array)
+- Max 500 entries (FIFO via `.slice(-499)` before appending, matching the existing `addAgentEvent` pattern). Session-scoped (cleared on page reload).
+
+**Files:**
+- `frontend/src/pages/LogsPage.tsx` — new page component
+- `frontend/src/types/index.ts` — add `LogEntry` interface
+- `frontend/src/lib/store.ts` — add `logEntries` array, `addLogEntry` action, `clearLogs` action
+- `frontend/src/components/Sidebar/Sidebar.tsx` — add Logs nav item
+- `frontend/src/App.tsx` — add route for `/logs`
+- `frontend/src/components/Chat/InputArea.tsx` — emit log entries for chat events
+- `frontend/src/components/CommandPalette.tsx` — emit log entries for model operations
+
+---
+
+## Non-Goals
+
+- No log persistence across sessions (localStorage is too small for meaningful logs)
+- No log filtering/search (keep it simple for v1)
+- No backend log forwarding (frontend-only collection from existing event streams)
+- No changes to the backend streaming protocol (already emits the events we need)
+- No Ollama-level model load progress bar (Ollama doesn't expose loading progress via API)
+- No Windows temperature support in v1
+
+---
+
+## Testing
+
+- Existing `tests/server/test_model_management.py` covers pull/delete/streaming endpoints (no changes needed)
+- Frontend: TypeScript compilation (`tsc --noEmit`) validates all type changes
+- Manual testing: verify all 6 changes in desktop app and web browser
+- Add a pytest test for the extended `/v1/telemetry/energy` response (temp fields present, nullable)
+
+---
+
+## Summary of Changes by File
+
+| File | Changes |
+|------|---------|
+| `SystemPanel.tsx` | Remove server-reported, rename ENERGY→DEVICE, add temps, remove Cool, use `getBase()` |
+| `Sidebar.tsx` | Add theme toggle icon, add Logs nav item, model loading spinner |
+| `InputArea.tsx` | Update phase labels ("Connecting...", "Calling ..."), disable during model loading |
+| `CommandPalette.tsx` | Trigger model preloading, emit log entries |
+| `store.ts` | Add `modelLoading`, `setModelLoading`, `logEntries`, `addLogEntry`, `clearLogs` |
+| `types/index.ts` | Add `LogEntry` interface |
+| `App.tsx` | Add `/logs` route, import LogsPage |
+| `LogsPage.tsx` | New file — timestamped log viewer with Copy All / Clear |
+| `api.ts` | Add `fetchDeviceInfo()`, `preloadModel()` functions |
+| `api_routes.py` | Extend `/v1/telemetry/energy` to include `cpu_temp_c`, `gpu_temp_c` |
+| `telemetry/` | Add CPU/GPU temp collection (macOS IOKit, Linux sysfs, NVIDIA already done) |