shortcutxl 0.3.77 → 0.3.78

package/dist/shell/status/update-check-scheduler.js

@@ -0,0 +1,71 @@
+export const UPDATE_CHECK_INTERVAL_MS = 12 * 60 * 60 * 1000;
+/** Schedules one coalesced asynchronous update check at most once per interval. */
+export class UpdateCheckScheduler {
+    options;
+    intervalMs;
+    now;
+    setTimer;
+    clearTimer;
+    timer;
+    inFlight;
+    nextCheckAt = Number.POSITIVE_INFINITY;
+    stopped = true;
+    constructor(options, deps = {}) {
+        this.options = options;
+        this.intervalMs = options.intervalMs ?? UPDATE_CHECK_INTERVAL_MS;
+        this.now = deps.now ?? Date.now;
+        this.setTimer = deps.setTimer ?? setTimeout;
+        this.clearTimer = deps.clearTimer ?? clearTimeout;
+    }
+    start(lastCheckedAt) {
+        this.stopped = false;
+        const lastCheckedAtMs = lastCheckedAt ? Date.parse(lastCheckedAt) : Number.NaN;
+        const delayMs = Number.isFinite(lastCheckedAtMs)
+            ? Math.min(this.intervalMs, Math.max(0, lastCheckedAtMs + this.intervalMs - this.now()))
+            : 0;
+        this.schedule(delayMs);
+    }
+    stop() {
+        this.stopped = true;
+        if (this.timer) {
+            this.clearTimer(this.timer);
+            this.timer = undefined;
+        }
+    }
+    schedule(delayMs) {
+        if (this.stopped)
+            return;
+        if (this.timer)
+            this.clearTimer(this.timer);
+        this.nextCheckAt = this.now() + delayMs;
+        this.timer = this.setTimer(() => {
+            this.timer = undefined;
+            this.runCheck();
+        }, delayMs);
+        this.timer.unref?.();
+    }
+    runCheck() {
+        if (this.stopped || this.inFlight)
+            return;
+        if (this.timer) {
+            this.clearTimer(this.timer);
+            this.timer = undefined;
+        }
+        this.nextCheckAt = this.now() + this.intervalMs;
+        const task = Promise.resolve()
+            .then(() => this.options.check())
+            .then((result) => {
+            if (!this.stopped)
+                this.options.onResult(result);
+        })
+            .catch(() => { })
+            .finally(() => {
+            if (this.inFlight !== task)
+                return;
+            this.inFlight = undefined;
+            this.schedule(Math.max(0, this.nextCheckAt - this.now()));
+        });
+        this.inFlight = task;
+    }
+}
+//# sourceMappingURL=update-check-scheduler.js.map

package/dist/shell/status/update-reminder-controller.d.ts

@@ -0,0 +1,22 @@
+import { Container } from '../../tui/index.js';
+import { type InteractiveAvailableUpdate } from './update-reminder.js';
+interface UpdateReminderControllerOptions {
+    initialUpdate?: InteractiveAvailableUpdate;
+    lastCheckedAt?: string;
+    checkForUpdate?: () => Promise<InteractiveAvailableUpdate | undefined>;
+    onChange: () => void;
+}
+/** Owns the live update state, reminder component, and non-blocking refresh schedule. */
+export declare class UpdateReminderController {
+    private readonly options;
+    readonly container: Container;
+    private update;
+    private readonly scheduler;
+    constructor(options: UpdateReminderControllerOptions);
+    start(): void;
+    stop(): void;
+    private setUpdate;
+    private render;
+}
+export {};
+//# sourceMappingURL=update-reminder-controller.d.ts.map

package/dist/shell/status/update-reminder-controller.js

@@ -0,0 +1,40 @@
+import { Container, Text } from '../../tui/index.js';
+import { theme } from '../theme/runtime.js';
+import { UpdateCheckScheduler } from './update-check-scheduler.js';
+import { formatUpdateReminder } from './update-reminder.js';
+/** Owns the live update state, reminder component, and non-blocking refresh schedule. */
+export class UpdateReminderController {
+    options;
+    container = new Container();
+    update;
+    scheduler;
+    constructor(options) {
+        this.options = options;
+        this.update = options.initialUpdate;
+        this.render();
+        this.scheduler = options.checkForUpdate
+            ? new UpdateCheckScheduler({
+                check: options.checkForUpdate,
+                onResult: (update) => this.setUpdate(update)
+            })
+            : null;
+    }
+    start() {
+        this.scheduler?.start(this.options.lastCheckedAt);
+    }
+    stop() {
+        this.scheduler?.stop();
+    }
+    setUpdate(update) {
+        this.update = update;
+        this.render();
+        this.options.onChange();
+    }
+    render() {
+        this.container.clear();
+        if (!this.update)
+            return;
+        this.container.addChild(new Text(theme.fg('accent', formatUpdateReminder(this.update)), 1, 0));
+    }
+}
+//# sourceMappingURL=update-reminder-controller.js.map

package/dist/shell/status/update-reminder.d.ts

@@ -0,0 +1,6 @@
+export interface InteractiveAvailableUpdate {
+    currentVersion: string;
+    latestVersion: string;
+}
+export declare function formatUpdateReminder(update: InteractiveAvailableUpdate): string;
+//# sourceMappingURL=update-reminder.d.ts.map

package/dist/shell/status/update-reminder.js

@@ -0,0 +1,4 @@
+export function formatUpdateReminder(update) {
+    return `Update available: ${update.currentVersion} → ${update.latestVersion}. Restart ShortcutXL and choose Update now.`;
+}
+//# sourceMappingURL=update-reminder.js.map

package/dist/shell/theme/dark.json

@@ -77,8 +77,7 @@
     "thinkingHigh": "#34d058",
     "thinkingXhigh": "brandGreen",
 
-    "bashMode": "#ff6eb4",
-    "chatMode": "#5bc0de"
+    "bashMode": "#ff6eb4"
   },
   "export": {
     "pageBg": "#18181b",

package/dist/shell/theme/light.json

@@ -77,8 +77,7 @@
     "thinkingHigh": "#088a43",
     "thinkingXhigh": "#059033",
 
-    "bashMode": "#d6336c",
-    "chatMode": "#0088aa"
+    "bashMode": "#d6336c"
   },
   "export": {
     "pageBg": "#fafafa",

package/dist/shell/theme/runtime.d.ts

@@ -1,4 +1,4 @@
-export type ThemeColor = 'accent' | 'border' | 'borderAccent' | 'borderMuted' | 'success' | 'error' | 'errorDim' | 'warning' | 'muted' | 'dim' | 'text' | 'thinkingText' | 'userMessageText' | 'customMessageText' | 'customMessageLabel' | 'toolTitle' | 'toolOutput' | 'mdHeading' | 'mdLink' | 'mdLinkUrl' | 'mdCode' | 'mdCodeBlock' | 'mdCodeBlockBorder' | 'mdQuote' | 'mdQuoteBorder' | 'mdHr' | 'mdListBullet' | 'toolDiffAdded' | 'toolDiffRemoved' | 'toolDiffContext' | 'syntaxComment' | 'syntaxKeyword' | 'syntaxFunction' | 'syntaxVariable' | 'syntaxString' | 'syntaxNumber' | 'syntaxType' | 'syntaxOperator' | 'syntaxPunctuation' | 'thinkingOff' | 'thinkingMinimal' | 'thinkingLow' | 'thinkingMedium' | 'thinkingHigh' | 'thinkingXhigh' | 'bashMode' | 'chatMode';
+export type ThemeColor = 'accent' | 'border' | 'borderAccent' | 'borderMuted' | 'success' | 'error' | 'errorDim' | 'warning' | 'muted' | 'dim' | 'text' | 'thinkingText' | 'userMessageText' | 'customMessageText' | 'customMessageLabel' | 'toolTitle' | 'toolOutput' | 'mdHeading' | 'mdLink' | 'mdLinkUrl' | 'mdCode' | 'mdCodeBlock' | 'mdCodeBlockBorder' | 'mdQuote' | 'mdQuoteBorder' | 'mdHr' | 'mdListBullet' | 'toolDiffAdded' | 'toolDiffRemoved' | 'toolDiffContext' | 'syntaxComment' | 'syntaxKeyword' | 'syntaxFunction' | 'syntaxVariable' | 'syntaxString' | 'syntaxNumber' | 'syntaxType' | 'syntaxOperator' | 'syntaxPunctuation' | 'thinkingOff' | 'thinkingMinimal' | 'thinkingLow' | 'thinkingMedium' | 'thinkingHigh' | 'thinkingXhigh' | 'bashMode';
 export type ThemeBg = 'selectedBg' | 'userMessageBg' | 'customMessageBg' | 'toolPendingBg' | 'toolSuccessBg' | 'toolErrorBg';
 type ColorMode = 'truecolor' | '256color';
 export declare class Theme {
@@ -23,7 +23,6 @@ export declare class Theme {
     getColorMode(): ColorMode;
     getThinkingBorderColor(level: 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max'): (str: string) => string;
     getBashModeBorderColor(): (str: string) => string;
-    getChatModeBorderColor(): (str: string) => string;
 }
 export declare function getAvailableThemes(): string[];
 export declare function loadThemeFromPath(themePath: string, mode?: ColorMode): Theme;

package/dist/shell/theme/runtime.js

@@ -74,9 +74,7 @@ const ThemeJsonSchema = Type.Object({
         thinkingHigh: ColorValueSchema,
         thinkingXhigh: ColorValueSchema,
         // Bash Mode (1 color)
-        bashMode: ColorValueSchema,
-        // Chat Mode (1 color — collab chat prefix)
-        chatMode: ColorValueSchema
+        bashMode: ColorValueSchema
     }),
     export: Type.Optional(Type.Object({
         pageBg: Type.Optional(ColorValueSchema),
@@ -330,9 +328,6 @@ export class Theme {
     getBashModeBorderColor() {
         return (str) => this.fg('bashMode', str);
     }
-    getChatModeBorderColor() {
-        return (str) => this.fg('chatMode', str);
-    }
 }
 // ============================================================================
 // Theme Loading

package/dist/shell/theme/theme-schema.json

@@ -85,8 +85,7 @@
         "thinkingMedium",
         "thinkingHigh",
         "thinkingXhigh",
-        "bashMode",
-        "chatMode"
+        "bashMode"
       ],
       "properties": {
         "accent": {
@@ -292,10 +291,6 @@
         "bashMode": {
           "$ref": "#/$defs/colorValue",
           "description": "Editor border color in bash mode"
-        },
-        "chatMode": {
-          "$ref": "#/$defs/colorValue",
-          "description": "Editor border color and text color in collab chat mode"
         }
       },
       "additionalProperties": false

package/dist/shortcut-model-catalog.js

@@ -107,13 +107,17 @@ const SHORTCUT_PUBLIC_MODEL_DEFINITIONS = [
         maxTokens: 128000,
         capabilities: {
             reasoning: {
-                control: 'fixed',
+                control: 'effort',
                 defaultLevel: 'high',
-                levels: ['high'],
-                supportsOff: false
+                levels: ['high', 'max'],
+                supportsOff: true
             }
         },
-        protocol: 'openai-completions'
+        protocol: 'openai-completions',
+        compat: {
+            supportsDeveloperRole: false,
+            supportsReasoningEffort: true
+        }
     },
     // Vision/extraction models the proxy routes to for llm_analysis, take_screenshot,
     // tool summaries, and durable memory. Registered so the api-v2 proxy client's
@@ -201,7 +205,10 @@ const SHORTCUT_HOSTED_MODEL_DEFINITIONS = [
         cost: { input: 0.195, output: 1.56, cacheRead: 0.0195, cacheWrite: 0 },
         contextWindow: HOSTED_CONTEXT_WINDOW_TOKENS,
         maxTokens: HOSTED_MAX_NEW_TOKENS,
-        protocol: 'openai-completions'
+        protocol: 'openai-completions',
+        compat: {
+            supportsDeveloperRole: false
+        }
     }
 ];
 function cloneShortcutModelDefinition(model) {

package/dist/startup/update-manager.d.ts

@@ -1,8 +1,8 @@
 /**
  * Startup-owned runtime package update detection and cache state.
  *
- * Reads a small local cache immediately, optionally refreshes it in the
- * background, and returns the update state for this run.
+ * Reads a small local cache for startup and exposes an explicit asynchronous
+ * refresh for the live shell.
  */
 interface UpdateCacheFile {
     latestVersion: string;
@@ -31,12 +31,12 @@ export interface ResolveUpdateOptions {
     packageName?: string;
     registryUrl?: string;
 }
-interface ResolveUpdateDeps {
+interface RefreshUpdateDeps {
     fetchLatestVersion?: (registryUrl: string) => Promise<string | undefined>;
-    scheduleBackgroundTask?: (task: () => Promise<void>) => void;
 }
-export declare function resolveStartupUpdateStatus(options?: ResolveUpdateOptions, deps?: ResolveUpdateDeps): Promise<UpdateStatus>;
-export declare function shouldRefreshUpdateCache(cache: UpdateCacheFile | undefined, now: Date, ttlMs?: number): boolean;
+export declare function resolveStartupUpdateStatus(options?: ResolveUpdateOptions): Promise<UpdateStatus>;
+/** Refresh the registry-backed cache without blocking startup or session changes. */
+export declare function refreshUpdateStatus(options?: ResolveUpdateOptions, deps?: RefreshUpdateDeps): Promise<UpdateStatus>;
 export declare function getUpdateStatusFromCache(cache: UpdateCacheFile | undefined, options: {
     currentVersion: string;
     packageName?: string;

package/dist/startup/update-manager.js

@@ -1,56 +1,47 @@
 /**
  * Startup-owned runtime package update detection and cache state.
  *
- * Reads a small local cache immediately, optionally refreshes it in the
- * background, and returns the update state for this run.
+ * Reads a small local cache for startup and exposes an explicit asynchronous
+ * refresh for the live shell.
  */
 import { mkdirSync, readFileSync, writeFileSync } from 'fs';
 import { dirname } from 'path';
 import { getUpdateCachePath, getUpdateCommand, getUpdateInstruction, NPM_PACKAGE_NAME, NPM_REGISTRY_URL, VERSION } from '../config.js';
-const UPDATE_CACHE_TTL_MS = 20 * 60 * 60 * 1000;
-export async function resolveStartupUpdateStatus(options = {}, deps = {}) {
+export async function resolveStartupUpdateStatus(options = {}) {
     const cachePath = options.cachePath ?? getUpdateCachePath();
     const currentVersion = options.currentVersion ?? VERSION;
     const packageName = options.packageName ?? NPM_PACKAGE_NAME;
-    const registryUrl = options.registryUrl ?? NPM_REGISTRY_URL;
-    const now = options.now ?? new Date();
     if (options.skipCheck) {
         return { kind: 'none', currentVersion };
     }
     const cache = readUpdateCache(cachePath);
-    // Cold-start users migrated from the old live-check flow do not have an
-    // update cache yet. Do one bounded foreground fetch so the first launch
-    // after the rollout can still show the update prompt immediately.
-    if (!options.offline && !cache) {
-        const refreshed = await fetchAndPersistUpdateCache({ cachePath, registryUrl, now }, { fetchLatestVersion: deps.fetchLatestVersion });
-        return getUpdateStatusFromCache(refreshed, {
-            currentVersion,
-            packageName
-        });
-    }
-    if (!options.offline && shouldRefreshUpdateCache(cache, now)) {
-        const scheduleBackgroundTask = deps.scheduleBackgroundTask ??
-            ((task) => {
-                void task().catch(() => { });
-            });
-        scheduleBackgroundTask(async () => {
-            await refreshUpdateCache({ cachePath, registryUrl, now }, { fetchLatestVersion: deps.fetchLatestVersion });
-        });
-    }
     return getUpdateStatusFromCache(cache, {
         currentVersion,
         packageName
     });
 }
-export function shouldRefreshUpdateCache(cache, now, ttlMs = UPDATE_CACHE_TTL_MS) {
-    if (!cache) {
-        return true;
+/** Refresh the registry-backed cache without blocking startup or session changes. */
+export async function refreshUpdateStatus(options = {}, deps = {}) {
+    const cachePath = options.cachePath ?? getUpdateCachePath();
+    const currentVersion = options.currentVersion ?? VERSION;
+    const packageName = options.packageName ?? NPM_PACKAGE_NAME;
+    const registryUrl = options.registryUrl ?? NPM_REGISTRY_URL;
+    const now = options.now ?? new Date();
+    const cache = readUpdateCache(cachePath);
+    if (options.skipCheck || options.offline) {
+        return getUpdateStatusFromCache(cache, { currentVersion, packageName });
     }
-    const lastCheckedAtMs = Date.parse(cache.lastCheckedAt);
-    if (!Number.isFinite(lastCheckedAtMs)) {
-        return true;
+    let refreshed;
+    try {
+        refreshed = await fetchAndPersistUpdateCache({ cachePath, registryUrl, now }, { fetchLatestVersion: deps.fetchLatestVersion });
     }
-    return now.getTime() - lastCheckedAtMs >= ttlMs;
+    catch {
+        // Keep the last known cache. The live scheduler will retry on its next interval.
+    }
+    return getUpdateStatusFromCache(refreshed ?? cache, {
+        currentVersion,
+        packageName
+    });
 }
 export function getUpdateStatusFromCache(cache, options) {
     const noUpdate = {
@@ -74,12 +65,6 @@ export function getUpdateStatusFromCache(cache, options) {
         lastCheckedAt: cache.lastCheckedAt
     };
 }
-async function refreshUpdateCache(options, deps = {}) {
-    const nextCache = await fetchAndPersistUpdateCache(options, deps);
-    if (!nextCache) {
-        return;
-    }
-}
 async function fetchAndPersistUpdateCache(options, deps = {}) {
     const fetchLatestVersion = deps.fetchLatestVersion ?? fetchLatestVersionFromRegistry;
     const latestVersion = await fetchLatestVersion(options.registryUrl);

package/dist/startup/update-prompt.d.ts

@@ -1,6 +1,7 @@
 import type { AvailableUpdate, UpdateStatus } from './update-manager.js';
 export type StartupUpdatePromptOutcome = {
     kind: 'continue';
+    updateStatus?: UpdateStatus;
 } | {
     kind: 'run-update';
     update: AvailableUpdate;

package/dist/startup/update-prompt.js

@@ -2,14 +2,14 @@ import chalk from 'chalk';
 import { emitKeypressEvents } from 'readline';
 export async function runStartupUpdatePromptIfNeeded(updateStatus, deps = {}) {
     if (deps.suppress || updateStatus.kind !== 'available' || !updateStatus.command) {
-        return { kind: 'continue' };
+        return { kind: 'continue', updateStatus };
     }
     const write = deps.write ?? ((text) => process.stdout.write(text));
     const promptSelection = deps.promptSelection ?? promptSelectionInteractive;
     const selection = await promptSelection(updateStatus, write);
     return selection === 'update-now'
         ? { kind: 'run-update', update: updateStatus }
-        : { kind: 'continue' };
+        : { kind: 'continue', updateStatus };
 }
 export function renderStartupUpdatePrompt(update, selected = 'update-now') {
     const optionRow = (option, label) => {

package/dist/tui/components/markdown.js

@@ -1,6 +1,11 @@
 import { marked } from 'marked';
 import { isImageLine } from '../terminal-image.js';
-import { applyBackgroundToLine, visibleWidth, wrapTextWithAnsi } from '../utils.js';
+import {
+  applyBackgroundToLine,
+  formatTerminalHyperlink,
+  visibleWidth,
+  wrapTextWithAnsi
+} from '../utils.js';
 export class Markdown {
   text;
   paddingX; // Left/right padding
@@ -316,6 +321,10 @@ export class Markdown {
           break;
         case 'link': {
           const linkText = this.renderInlineTokens(token.tokens || [], resolvedStyleContext);
+          const styledLink = formatTerminalHyperlink(
+            this.theme.link(this.theme.underline(linkText)),
+            token.href
+          );
           // If link text matches href, only show the link once
           // Compare raw text (token.text) not styled text (linkText) since linkText has ANSI codes
           // For mailto: links, strip the prefix before comparing (autolinked emails have
@@ -324,12 +333,12 @@ export class Markdown {
             ? token.href.slice(7)
             : token.href;
           if (token.text === token.href || token.text === hrefForComparison) {
-            result += this.theme.link(this.theme.underline(linkText)) + stylePrefix;
+            result += styledLink + stylePrefix;
+          } else if (token.href.startsWith('file:')) {
+            // Absolute file URLs can be long and noisy. Keep the full path in hyperlink metadata.
+            result += styledLink + stylePrefix;
           } else {
-            result +=
-              this.theme.link(this.theme.underline(linkText)) +
-              this.theme.linkUrl(` (${token.href})`) +
-              stylePrefix;
+            result += styledLink + this.theme.linkUrl(` (${token.href})`) + stylePrefix;
           }
           break;
         }

package/dist/tui/index.d.ts

@@ -76,5 +76,11 @@ export {
   type OverlayOptions,
   type SizeValue
 } from './tui.js';
-export { truncateToWidth, visibleWidth, wrapTextWithAnsi } from './utils.js';
+export {
+  formatTerminalHyperlink,
+  getTerminalHyperlinkAtColumn,
+  truncateToWidth,
+  visibleWidth,
+  wrapTextWithAnsi
+} from './utils.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/tui/index.js

@@ -56,5 +56,11 @@ export {
 } from './terminal-image.js';
 export { CURSOR_MARKER, Container, ScrollContainer, TUI, isFocusable } from './tui.js';
 // Utilities
-export { truncateToWidth, visibleWidth, wrapTextWithAnsi } from './utils.js';
+export {
+  formatTerminalHyperlink,
+  getTerminalHyperlinkAtColumn,
+  truncateToWidth,
+  visibleWidth,
+  wrapTextWithAnsi
+} from './utils.js';
 //# sourceMappingURL=index.js.map

package/dist/tui/tui.d.ts

@@ -209,6 +209,8 @@ export declare class TUI extends Container {
   setClearOnShrink(enabled: boolean): void;
   setFocus(component: Component | null): void;
   getFocusedComponent(): Component | null;
+  /** Resolve an OSC 8 hyperlink from one-based terminal screen coordinates. */
+  getHyperlinkAtScreenPosition(row: number, col: number): string | undefined;
   /**
    * Show an overlay component with configurable positioning and sizing.
    * Returns a handle to control the overlay's visibility.

package/dist/tui/tui.js

@@ -6,7 +6,13 @@ import * as os from 'node:os';
 import * as path from 'node:path';
 import { isKeyRelease, matchesKey } from './keys.js';
 import { getCapabilities, isImageLine, setCellDimensions } from './terminal-image.js';
-import { extractSegments, sliceByColumn, sliceWithWidth, visibleWidth } from './utils.js';
+import {
+  extractSegments,
+  getTerminalHyperlinkAtColumn,
+  sliceByColumn,
+  sliceWithWidth,
+  visibleWidth
+} from './utils.js';
 /** Type guard to check if a component implements Focusable */
 export function isFocusable(component) {
   return component !== null && 'focused' in component;
@@ -255,6 +261,15 @@ export class TUI extends Container {
   getFocusedComponent() {
     return this.focusedComponent;
   }
+  /** Resolve an OSC 8 hyperlink from one-based terminal screen coordinates. */
+  getHyperlinkAtScreenPosition(row, col) {
+    if (!Number.isInteger(row) || !Number.isInteger(col) || row < 1 || col < 1) {
+      return undefined;
+    }
+    const lineIndex = this.previousViewportTop + row - 1;
+    const line = this.previousLines[lineIndex];
+    return line === undefined ? undefined : getTerminalHyperlinkAtColumn(line, col - 1);
+  }
   /**
    * Show an overlay component with configurable positioning and sizing.
    * Returns a handle to control the overlay's visibility.

package/dist/tui/utils.d.ts

@@ -6,6 +6,13 @@ export declare function getSegmenter(): Intl.Segmenter;
  * Calculate the visible width of a string in terminal columns.
  */
 export declare function visibleWidth(str: string): number;
+/** Wrap terminal text in a safe OSC 8 hyperlink for supported URL schemes. */
+export declare function formatTerminalHyperlink(text: string, href: string): string;
+/** Return the active OSC 8 hyperlink at a zero-based terminal column. */
+export declare function getTerminalHyperlinkAtColumn(
+  line: string,
+  targetColumn: number
+): string | undefined;
 /**
  * Extract ANSI escape sequences from a string at the given position.
  */

package/dist/tui/utils.js

@@ -171,7 +171,13 @@ class AnsiCodeTracker {
   strikethrough = false;
   fgColor = null; // Stores the full code like "31" or "38;5;240"
   bgColor = null; // Stores the full code like "41" or "48;5;240"
+  hyperlinkUrl = null;
   process(ansiCode) {
+    const hyperlinkMatch = ansiCode.match(/^\x1b\]8;[^;]*;(.*?)(?:\x07|\x1b\\)$/s);
+    if (hyperlinkMatch) {
+      this.hyperlinkUrl = hyperlinkMatch[1] || null;
+      return;
+    }
     if (!ansiCode.endsWith('m')) {
       return;
     }
@@ -304,6 +310,7 @@ class AnsiCodeTracker {
   /** Clear all state for reuse. */
   clear() {
     this.reset();
+    this.hyperlinkUrl = null;
   }
   getActiveCodes() {
     const codes = [];
@@ -317,8 +324,9 @@ class AnsiCodeTracker {
     if (this.strikethrough) codes.push('9');
     if (this.fgColor) codes.push(this.fgColor);
     if (this.bgColor) codes.push(this.bgColor);
-    if (codes.length === 0) return '';
-    return `\x1b[${codes.join(';')}m`;
+    const sgr = codes.length === 0 ? '' : `\x1b[${codes.join(';')}m`;
+    const hyperlink = this.hyperlinkUrl ? `\x1b]8;;${this.hyperlinkUrl}\x07` : '';
+    return hyperlink + sgr;
   }
   hasActiveCodes() {
     return (
@@ -331,7 +339,8 @@ class AnsiCodeTracker {
       this.hidden ||
       this.strikethrough ||
       this.fgColor !== null ||
-      this.bgColor !== null
+      this.bgColor !== null ||
+      this.hyperlinkUrl !== null
     );
   }
   /**
@@ -340,13 +349,54 @@ class AnsiCodeTracker {
    * Returns empty string if no problematic attributes are active.
    */
   getLineEndReset() {
-    // Only underline causes visual bleeding into padding
-    // Other attributes like colors don't visually bleed to padding
-    if (this.underline) {
-      return '\x1b[24m'; // Underline off only
+    const underlineReset = this.underline ? '\x1b[24m' : '';
+    const hyperlinkReset = this.hyperlinkUrl ? '\x1b]8;;\x07' : '';
+    return underlineReset + hyperlinkReset;
+  }
+}
+
+const CLICKABLE_PROTOCOLS = new Set(['file:', 'http:', 'https:', 'mailto:']);
+
+/** Wrap terminal text in a safe OSC 8 hyperlink for supported URL schemes. */
+export function formatTerminalHyperlink(text, href) {
+  if (typeof href !== 'string' || href.length === 0 || href.length > 8192) return text;
+  if (/[\u0000-\u001f\u007f]/u.test(href)) return text;
+  try {
+    const url = new URL(href);
+    if (!CLICKABLE_PROTOCOLS.has(url.protocol)) return text;
+  } catch {
+    return text;
+  }
+  return `\x1b]8;;${href}\x07${text}\x1b]8;;\x07`;
+}
+
+/** Return the active OSC 8 hyperlink at a zero-based terminal column. */
+export function getTerminalHyperlinkAtColumn(line, targetColumn) {
+  if (!Number.isInteger(targetColumn) || targetColumn < 0) return undefined;
+
+  let activeHref;
+  let column = 0;
+  let index = 0;
+  while (index < line.length) {
+    const ansi = extractAnsiCode(line, index);
+    if (ansi) {
+      const hyperlinkMatch = ansi.code.match(/^\x1b\]8;[^;]*;(.*?)(?:\x07|\x1b\\)$/s);
+      if (hyperlinkMatch) activeHref = hyperlinkMatch[1] || undefined;
+      index += ansi.length;
+      continue;
+    }
+
+    let textEnd = index + 1;
+    while (textEnd < line.length && line[textEnd] !== '\x1b') textEnd++;
+    const text = line.slice(index, textEnd);
+    for (const { segment } of segmenter.segment(text)) {
+      const width = graphemeWidth(segment);
+      if (targetColumn >= column && targetColumn < column + width) return activeHref;
+      column += width;
     }
-    return '';
+    index = textEnd;
   }
+  return undefined;
 }
 function updateTrackerFromText(text, tracker) {
   let i = 0;

package/native-app/main/index.js

@@ -8549,7 +8549,7 @@ function createWindow() {
     minWidth: 820,
     minHeight: 560,
     title: "Shortcut CLI",
-    backgroundColor: "#f7f9f6",
+    backgroundColor: "#f5f5f5",
     webPreferences: {
       preload: join(__dirname, "../preload/index.cjs"),
       contextIsolation: true,