Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
feat(open-knowledge): add OpenClaw + Hermes "Open with AI" terminal targets (#2758)
mike-inkeep0c0ffb50bbff
diff --git a/.changeset/open-with-openclaw-hermes.md b/.changeset/open-with-openclaw-hermes.mdnew file mode 100644index 000000000..404f96c0c--- /dev/null+++ b/.changeset/open-with-openclaw-hermes.md@@ -0,0 +1,5 @@+---+"@inkeep/open-knowledge": patch+---++Added OpenClaw and Hermes as "Open with AI" terminal launch targets in OK Desktop, alongside the existing agent CLIs. OpenClaw opens its interactive TUI seeded with the composed prompt via `openclaw chat --message '<prompt>'`. Hermes has no starting-prompt argument (its only prompt-carrying modes run once and exit), so OK launches `hermes chat` and, once Hermes signals its input is ready, delivers the prompt as a bracketed-paste write — bracketed paste keeps a multi-line prompt intact and inert to the TUI's key handling, then submits it. The paste waits for Hermes' readiness signal (with a timeout fallback) rather than a fixed delay, so it lands cleanly on slow and fast boots alike. Both were already supported as MCP servers; this adds the one-click terminal handoff.diff --git a/packages/app/src/components/TerminalPanel.launch.dom.test.tsx b/packages/app/src/components/TerminalPanel.launch.dom.test.tsxindex 1aa52aabb..b55f2f2cb 100644--- a/packages/app/src/components/TerminalPanel.launch.dom.test.tsx+++ b/packages/app/src/components/TerminalPanel.launch.dom.test.tsx@@ -15,7 +15,7 @@*/import { afterEach, beforeEach, describe, expect, mock, test } from 'bun:test';-import type { TerminalCli } from '@inkeep/open-knowledge-core';+import { buildStartupInjectionBytes, type TerminalCli } from '@inkeep/open-knowledge-core';import { act, cleanup, render, screen, waitFor } from '@testing-library/react';import type { ReactElement } from 'react';import { ConfigContext, type ConfigContextValue } from '@/lib/config-context';@@ -248,6 +248,55 @@ describe('TerminalPanel "Open in terminal" launch (baked into the PTY spawn)', (expect(terminal.input.mock.calls.every((c) => !(c[1] as string).includes('\r'))).toBe(true);});+ test('a Hermes launch bakes promptless `hermes chat` and injects the prompt only after the ready marker (ESC[?2004h)', async () => {+ const { bridge, terminal, pushData } = makeBridge();+ const prompt = 'summarize @notes.md\nthen link the people';+ render(<TerminalPanel bridge={bridge} launch={{ prompt, cli: 'hermes', nonce: 1 }} />);++ await waitFor(() => expect(terminal.create).toHaveBeenCalledTimes(1));+ // Hermes takes no argv prompt, so the bake is the bare interactive TUI — the+ // prompt is NOT on the command line.+ expect(bakedLaunch(terminal.create)).toBe('hermes chat');+ expect(bakedLaunch(terminal.create)).not.toContain(prompt);++ // Nothing is injected while the TUI is still booting — the paste waits for the+ // input widget to signal ready, so a slow boot can't drop bytes into a+ // not-yet-listening reader.+ await new Promise((r) => setTimeout(r, 80));+ expect(terminal.input).not.toHaveBeenCalled();++ // Hermes emits ESC[?2004h (bracketed-paste enable) when its prompt mounts.+ pushData({ ptyId: 'pty-1', data: '\x1b[?2004h' });++ // Now the composed prompt lands via `input`, wrapped in bracketed paste+ // (multi-line-safe) and followed by the submit byte. Derived from core so the+ // escape framing can't rot into a hand-copied literal.+ const expectedBytes = buildStartupInjectionBytes('hermes', prompt);+ expect(expectedBytes).not.toBeNull();+ await waitFor(() => expect(terminal.input).toHaveBeenCalledWith('pty-1', expectedBytes), {+ timeout: 2_000,+ });+ // The multi-line prompt survives intact inside the paste frame (no early submit+ // on the interior newline): exactly one submit `\r`, at the very end.+ expect(expectedBytes?.endsWith('\r')).toBe(true);+ expect(expectedBytes?.slice(0, -1).includes('\r')).toBe(false);+ }, 10_000);++ test('a Hermes launch injects via the cap fallback even if the ready marker never arrives', async () => {+ const { bridge, terminal } = makeBridge();+ const prompt = 'do the thing';+ render(<TerminalPanel bridge={bridge} launch={{ prompt, cli: 'hermes', nonce: 1 }} />);++ await waitFor(() => expect(terminal.create).toHaveBeenCalledTimes(1));+ // No marker is ever pushed. The prompt must still be delivered (the cap+ // fallback), so a future Hermes that changed its ready signal never silently+ // drops it.+ const expectedBytes = buildStartupInjectionBytes('hermes', prompt);+ await waitFor(() => expect(terminal.input).toHaveBeenCalledWith('pty-1', expectedBytes), {+ timeout: 6_000,+ });+ }, 10_000);+test('stagePaste is DROPPED when the bake was suppressed — staged text in the bare-shell fallback would execute', async () => {const { bridge, terminal } = makeBridge({ claude: 'not-found', mcp: 'needs-rewire' });render(diff --git a/packages/app/src/components/TerminalPanel.tsx b/packages/app/src/components/TerminalPanel.tsxindex ac90bb941..b90940dcf 100644--- a/packages/app/src/components/TerminalPanel.tsx+++ b/packages/app/src/components/TerminalPanel.tsx@@ -2,7 +2,9 @@ import '@xterm/xterm/css/xterm.css';import {buildCliLaunchArgString,+ buildStartupInjectionBytes,shellSingleQuote,+ startupInjectionFor,type TerminalCli,} from '@inkeep/open-knowledge-core';import { useLingui } from '@lingui/react/macro';@@ -230,6 +232,13 @@ function TerminalSession({let ptyId: string | null = null;let unsubData: (() => void) | undefined;let unsubExit: (() => void) | undefined;+ // Startup-injection readiness: for a `startupInjection` CLI (Hermes), this+ // scans the PTY output for the CLI's ready marker so the prompt is pasted the+ // instant the input widget is live. Fed from attachSession's onData; armed by+ // the post-attach launch block. `injectCapTimer` is the marker-never-appears+ // fallback. Both are torn down on unmount alongside `stagePasteTimer`.+ let readinessScan: ((data: string) => void) | undefined;+ let injectCapTimer: ReturnType<typeof setTimeout> | undefined;let titleDisposable: { dispose(): void } | undefined;let linkProviderDisposable: { dispose(): void } | undefined;let observer: ResizeObserver | undefined;@@ -599,6 +608,8 @@ function TerminalSession({// Ack consumed code units only once xterm has processed the chunk, so// the main-side backpressure window tracks real consumption.term.write(msg.data, () => bridge.terminal.drain(msg.ptyId, msg.data.length));+ // Watch for a startup-injection CLI's ready marker (no-op unless armed).+ readinessScan?.(msg.data);});unsubExit = bridge.terminal.onExit((msg) => {@@ -837,7 +848,62 @@ function TerminalSession({// beat lets the TUI's stdin reader attach (a write at raw PTY-live can// race it); unmount cancels the timer.const staged = launch?.stagePaste;- if (launch != null && launch.prompt != null && staged != null) {+ // Hermes-class CLIs take no starting-prompt argument, so their `chat` TUI is+ // launched promptless (`launchCommand` = `hermes chat`) and the composed+ // prompt is delivered HERE as a bracketed-paste PTY write once the TUI's+ // stdin reader has attached — the same `bridge.terminal.input` channel as+ // stagePaste, but framed (multi-line-safe) and submitted. Non-null only for+ // a `startupInjection` CLI with a non-empty prompt AND a confirmed bake+ // (preflight put the CLI on PATH); a suppressed launchCommand means a bare+ // shell, where injecting would mangle, so it stays null. `settleMs` is the+ // known-fragile knob — if it proves unreliable the fallback is clipboard ++ // a paste hint, not a longer guess.+ const injectionBytes =+ launch != null && launchCommand !== undefined && launch.prompt != null+ ? buildStartupInjectionBytes(launch.cli, launch.prompt)+ : null;+ if (injectionBytes != null && launch != null) {+ const cfg = startupInjectionFor(launch.cli);+ const settleMs = cfg?.settleMs ?? STAGE_PASTE_SETTLE_MS;+ const marker = cfg?.readyMarker;+ const bytes = injectionBytes;+ let fired = false;+ const inject = () => {+ if (fired) return;+ fired = true;+ readinessScan = undefined;+ if (stagePasteTimer !== undefined) clearTimeout(stagePasteTimer);+ if (injectCapTimer !== undefined) clearTimeout(injectCapTimer);+ if (cancelled || ptyIdRef.current === null) return;+ bridge.terminal.input(ptyIdRef.current, bytes);+ term.focus();+ };+ // Cap fallback: inject even if the marker never appears, so a future TUI+ // that changed its ready signal never silently drops the prompt.+ injectCapTimer = setTimeout(inject, cfg?.capMs ?? settleMs);+ if (marker != null) {+ // Inject once the input widget signals ready (Hermes: bracketed-paste+ // enable), then a short debounce — pasting the instant it's live instead+ // of guessing a fixed boot time.+ let acc = '';+ readinessScan = (data) => {+ if (fired || stagePasteTimer !== undefined) return;+ acc += data;+ if (acc.includes(marker)) {+ readinessScan = undefined;+ stagePasteTimer = setTimeout(inject, settleMs);+ return;+ }+ // Bound the buffer, keeping enough tail to catch a marker split across+ // chunks. Trim only after a non-match so an early-in-a-big-chunk marker+ // is never sliced away before the includes() check above.+ if (acc.length > marker.length + 256) acc = acc.slice(-(marker.length + 256));+ };+ } else {+ // No marker configured — a fixed beat from spawn (legacy behavior).+ stagePasteTimer = setTimeout(inject, settleMs);+ }+ } else if (launch != null && launch.prompt != null && staged != null) {// `prompt` and `stagePaste` are mutually exclusive by the intent's// contract (the type doesn't forbid it — single producer today). A// future producer setting both would double-dispatch: the prompt@@ -859,6 +925,8 @@ function TerminalSession({return () => {cancelled = true;if (stagePasteTimer !== undefined) clearTimeout(stagePasteTimer);+ if (injectCapTimer !== undefined) clearTimeout(injectCapTimer);+ readinessScan = undefined;ptyIdRef.current = null;// This session no longer has a live PTY — clear it from the host's reuse// map so an "Ask AI" launch never writes into a torn-down shell.diff --git a/packages/app/src/components/handoff/OpenInAgentMenuItem.tsx b/packages/app/src/components/handoff/OpenInAgentMenuItem.tsxindex 230d182a4..709088747 100644--- a/packages/app/src/components/handoff/OpenInAgentMenuItem.tsx+++ b/packages/app/src/components/handoff/OpenInAgentMenuItem.tsx@@ -39,6 +39,8 @@ import { ClaudeIcon } from '@/components/icons/claude';import { CodexBrandIcon } from '@/components/icons/codex';import { CopilotIcon } from '@/components/icons/copilot';import { CursorIcon } from '@/components/icons/cursor';+import { HermesIcon } from '@/components/icons/hermes';+import { OpenClawIcon } from '@/components/icons/openclaw';import { OpenCodeIcon } from '@/components/icons/opencode';import { PiIcon } from '@/components/icons/pi';import {@@ -72,10 +74,13 @@ const TARGET_ICON_KEY: Record<TargetData['id'], string> = {cursor: 'cursor',copilot: 'github',// No `AGENT_ICON_COLORS` entry → renders monochrome (inherits the row's text- // color), which suits OpenCode's, Pi's, and Antigravity's monochrome brand marks.+ // color), which suits OpenCode's, Pi's, Antigravity's, OpenClaw's, and Hermes'+ // monochrome brand marks.opencode: 'opencode',pi: 'pi',antigravity: 'antigravity',+ openclaw: 'openclaw',+ hermes: 'hermes',};export function TargetIcon({@@ -113,6 +118,9 @@ export function TargetIcon({if (id === 'pi') return <PiIcon style={mergedStyle} className={mergedClass} {...props} />;if (id === 'antigravity')return <AntigravityIcon style={mergedStyle} className={mergedClass} {...props} />;+ if (id === 'openclaw')+ return <OpenClawIcon style={mergedStyle} className={mergedClass} {...props} />;+ if (id === 'hermes') return <HermesIcon style={mergedStyle} className={mergedClass} {...props} />;return null;}diff --git a/packages/app/src/components/icons/hermes.tsx b/packages/app/src/components/icons/hermes.tsxnew file mode 100644index 000000000..1f5c22b04--- /dev/null+++ b/packages/app/src/components/icons/hermes.tsx@@ -0,0 +1,28 @@+import type { SVGProps } from 'react';++// Hermes Agent brand mark (Nous Research), flattened to a single `currentColor`+// silhouette so it tracks the sidebar text color and brightens on hover like+// every other brand icon. viewBox 0 0 24 24 to match Lucide sizing.+export function HermesIcon(props: SVGProps<SVGSVGElement>) {+ return (+ <svg+ role="img"+ aria-label="Hermes icon"+ xmlns="http://www.w3.org/2000/svg"+ width={24}+ height={24}+ fill="currentColor"+ fillRule="evenodd"+ viewBox="0 0 24 24"+ {...props}+ >+ <title>Hermes icon</title>+ <path d="M5.938 12.835c.127-.039.285.02.373.143.028.038.036.092.046.14.003.014-.02.033-.04.05-.124-.098-.24-.194-.354-.291-.011-.01-.016-.027-.025-.042zM8.396 9.412c.195-.032.39-.06.588-.05a.54.54 0 01.148.026c.202.071.402.147.601.224.028.01.05.036.075.055l-.013.027a9.203 9.203 0 01-.26-.089c-.115-.038-.213-.077-.315-.098-.25-.05-.25-.046-.292-.014l.574.144c.275.139.55.276.823.417.042.022.09.057.107.098.026.06.063.076.117.072.066-.006.132-.017.213-.027l-.04.086c.051.08.142.02.216.064-.074.13-.247.09-.334.199l.061.074-.12.087c0 .106-.038.168-.306.243l.026.085-.196.042.07.124h-.25l-.007.137c-.081-.01-.161-.018-.244-.027l-.053.123c-.027-.008-.052-.011-.073-.023-.067-.038-.128-.056-.195.006-.019.017-.063.014-.093.008-.026-.006-.05-.029-.07-.042-.11.095-.11.095-.208.003-.057.046-.12.074-.186.011-.063.027-.123-.02-.178-.014-.07.007-.097-.035-.133-.07l-.13.033c-.013-.236-.194-.19-.34-.203.005-.072.05-.092.095-.094a.474.474 0 01.159.022c.164.05.32.12.496.138.203.021.405.029.601-.015.265-.059.52-.149.707-.365.049-.056.083-.127.117-.195.019-.038.02-.084-.02-.116a1.397 1.397 0 00-.382-.217c.024.12-.031.182-.115.221 0 .014-.004.025 0 .03.08.115.084.16-.007.267a1.39 1.39 0 01-.218.211.477.477 0 01-.641-.05 1.36 1.36 0 01-.133-.152c-.078-.107-.076-.108-.033-.236-.165-.08-.128-.226-.104-.364.008-.05.028-.096.049-.163-.04.014-.067.017-.087.032a.897.897 0 00-.316.357c-.007.016-.01.034-.02.047-.012.015-.034.038-.045.035-.02-.006-.037-.027-.05-.045-.008-.012-.007-.032-.012-.057h-.126l.053-.172a14.82 14.82 0 00-.039-.049l.11-.284c-.06.026-.091.044-.124.051-.03.007-.064 0-.095 0 0-.031-.01-.07.004-.092.149-.22.305-.428.593-.476z"></path>+ <path d="M8.06 10.788c-.003-.038-.004-.075.037-.062.016.006.034.048.028.067-.01.04-.038.032-.064-.005z"></path>+ <path+ clipRule="evenodd"+ d="M11.981.009c.226-.012.453-.011.679 0 .247.01.495.024.74.062.401.064.798.157 1.19.273.463.138.92.299 1.356.511a7.31 7.31 0 012.948 2.642c.292.469.536.963.739 1.479.219.556.446 1.11.623 1.683.204.654.329 1.326.458 1.997.097.504.182 1.01.29 1.511.156.722.329 1.44.494 2.16.186.812.4 1.615.63 2.415.102.355.193.713.282 1.072.11.436.202.876.254 1.323.031.278.066.557.073.837a7.56 7.56 0 01-.017.88c-.037.413-.1.818-.226 1.212a5.017 5.017 0 01-.915 1.649l-.13.156.018.023c.043-.023.088-.041.127-.068.2-.138.373-.307.531-.49.4-.46.721-.973.975-1.529a3.59 3.59 0 00.325-1.72c-.024-.424-.097-.834-.3-1.213-.013-.027-.015-.06-.03-.121.05.035.082.048.101.072.107.13.22.258.315.398.33.494.46 1.052.486 1.64a3.75 3.75 0 01-.47 1.97c-.36.655-.887 1.14-1.526 1.506-.193.111-.394.21-.595.308-.157.078-.248.211-.318.365a.522.522 0 00-.033.406.359.359 0 01.013.139c-.005.077-.077.155-.14.162-.054.006-.125-.043-.15-.116a1.206 1.206 0 01-.06-.233c-.04-.314-.155-.6-.308-.87a3.906 3.906 0 00-.73-.91 2.129 2.129 0 00-.897-.524 4.093 4.093 0 00-.692-.131c-.075-.008-.15-.04-.22.01.18.06.363.11.538.18.434.173.82.43 1.18.728.308.255.58.543.794.884.098.155.186.315.227.496.027.123.042.25.067.375.013.062-.002.109-.053.144-.047.033-.122.034-.163-.01a.455.455 0 01-.08-.14c-.03-.073-.038-.159-.078-.225a7.314 7.314 0 00-1.423-1.664c-.16-.137-.329-.26-.537-.323-.376-.114-.753-.203-1.15-.154-.213.025-.427.032-.64.053a1.6 1.6 0 00-.736.278 5.14 5.14 0 00-.834.72c-.329.342-.642.699-.955 1.055-.136.155-.264.319-.314.531a5.227 5.227 0 00-.012.051.096.096 0 01-.09.076h-.31c-.046 0-.082-.048-.072-.094.023-.108.045-.216.07-.324.075-.325.19-.635.368-.917.024-.039.04-.088.104-.08l.01.049.027.077c.28-.435.571-.834.996-1.135.283-.204.584-.378.89-.55a.196.196 0 00-.098-.002c-.162.043-.325.084-.485.134-.402.124-.764.33-1.11.566-.147.1-.298.193-.414.333a7.314 7.314 0 00-1.07 1.767.845.845 0 00-.04.12.075.075 0 01-.072.056h-.494c-.04 0-.062-.051-.036-.082.123-.14.246-.282.377-.415.275-.281.58-.532.777-.884.027-.048.063-.09.095-.135.238-.333.54-.607.818-.902.082-.086.175-.16.26-.24.029-.027.053-.057.079-.085l-.018-.025-.135.041c-.034.017-.07.031-.102.05-.248.144-.494.292-.743.433-.408.23-.825.439-1.209.711-.281.2-.591.358-.889.533-.02.012-.044.015-.08.028-.015-.135.143-.201.108-.336-.033.014-.064.02-.085.038-.111.096-.227.19-.328.296-.148.157-.284.325-.425.488-.125.143-.25.286-.373.431A.153.153 0 019.89 24H8.762a.316.316 0 00.016-.042c.028-.09.085-.172.083-.28-.091-.018-.162.001-.212.077a4.45 4.45 0 00-.136.215c-.01.016-.024.03-.042.03h-.093c-.019 0-.029-.022-.017-.037.071-.088.14-.178.209-.268.001-.002-.006-.012-.012-.024-.014.004-.03.006-.045.013-.176.09-.352.181-.527.274a.363.363 0 01-.168.042H5.202c-.026 0-.039-.036-.019-.053.21-.178.402-.374.558-.605.335-.496.538-1.047.667-1.629.004-.02-.003-.043-.006-.091-.037.048-.059.072-.076.1a1.943 1.943 0 01-.334.415c-.28.258-.59.448-.983.464-.297.012-.588 0-.865-.127-.46-.21-.722-.57-.794-1.072-.025-.17-.017-.171-.182-.219A3.513 3.513 0 011.97 20.6a2.286 2.286 0 01-.808-1.13 3.569 3.569 0 01-.16-1.245c.002-.034.016-.067.024-.1.032.023.046.043.05.066.033.153.059.308.096.46.086.355.257.664.516.92.258.256.571.419.91.532.358.118.717.138 1.07-.016a1.89 1.89 0 00.621-.452c.328-.348.533-.76.648-1.223.009-.034.005-.071.007-.11-.015.006-.026.006-.03.011-.031.05-.064.1-.093.152-.284.502-.679.887-1.196 1.135-.351.17-.718.255-1.11.159a1.607 1.607 0 01-.971-.64 2.006 2.006 0 01-.368-.924 2.903 2.903 0 01.02-.886c.05-.439.466-1.17.742-1.271-.02.063-.035.112-.053.16-.043.116-.097.227-.13.345a1.901 1.901 0 00-.05.82c.033.212.09.416.204.6.147.236.346.407.62.465.11.023.225.014.338.018a.576.576 0 00.386-.131c.164-.128.282-.292.366-.481.168-.375.24-.777.309-1.179.05-.296.093-.594.133-.893.039-.281.071-.563.104-.845.026-.232.048-.464.074-.696.024-.228.052-.455.076-.683.024-.227.047-.455.069-.683.013-.14.022-.28.034-.42l.037-.417c.022-.25.041-.5.065-.748.008-.082-.02-.132-.09-.177a2.46 2.46 0 01-.492-.418c-.1-.109-.188-.228-.282-.342-.035-.042-.056-.097-.116-.118a2.084 2.084 0 00.275.597c.06.092.131.176.196.265.063.086.182.115.234.226-.028.003-.046.01-.06.006a4.74 4.74 0 01-.22-.057 2.71 2.71 0 01-1.287-.819c-.435-.487-.656-1.076-.71-1.723a5.206 5.206 0 01.014-1.06c.072-.602.22-1.186.45-1.745.155-.376.338-.741.526-1.102.205-.393.466-.75.765-1.076.512-.559 1.104-1.024 1.726-1.448.717-.49 1.478-.898 2.277-1.233C8.244.828 8.767.632 9.31.494c.655-.166 1.31-.33 1.982-.415.229-.03.458-.058.688-.07zm-1.847 22.82c-.07.06-.147.111-.207.18-.238.27-.464.549-.668.869l-.044.108a.177.177 0 00.093-.057c.174-.19.351-.378.519-.574.104-.122.195-.255.288-.386.024-.034.03-.08.046-.12l-.027-.02zm1.65-3.695a5.51 5.51 0 00-.653.593l-.37.386a.963.963 0 01-.377.25 1.372 1.372 0 01-.467.09c-.044 0-.087.006-.151.012.028.058.043.097.064.131.15.242.301.482.45.724.136.22.276.438.399.666.068.125.105.267.156.404.077.027.14-.018.202-.048.29-.135.579-.274.867-.412.213-.101.437-.186.636-.31.347-.215.68-.455 1.018-.685.015-.01.026-.028.042-.046-.023-.019-.038-.037-.056-.044-.287-.111-.527-.3-.77-.482a5.319 5.319 0 01-.506-.42 1.757 1.757 0 01-.41-.653c-.019-.049-.045-.095-.075-.156zm-5.847.264c-.06.096-.097.194-.132.293a3.38 3.38 0 01-.555 1.01c-.2.25-.455.412-.762.493-.23.06-.464.076-.7.07-.048-.002-.097.002-.158.005.016.04.021.066.035.085.1.145.23.246.4.295.157.046.316.034.498.023.181-.037.343-.115.485-.234.238-.199.402-.454.536-.732.175-.363.264-.751.342-1.144.01-.053.008-.11.011-.164zm14.945-4.586c.008.029.016.057.027.107.024.155.051.31.072.464.03.219.067.437.078.657.017.344.027.689-.014 1.033-.037.315-.063.633-.116.946a6.153 6.153 0 01-.46 1.518c-.008.018-.01.039-.02.082.047-.03.077-.042.098-.064.085-.083.17-.167.248-.255.271-.305.458-.66.596-1.043.18-.498.228-1.011.145-1.531-.103-.65-.33-1.263-.597-1.881a9.055 9.055 0 00-.024-.055l-.033.022zM5.797 8.29a.26.26 0 00.018.153c.124.251.25.501.379.75.025.049.066.09.03.163-.284.06-.578.119-.88.255.059.038.097.06.132.087.042.032.112.058.09.12-.01.033-.075.048-.117.072.017.01.043.021.067.036.166.102.33.207.447.368.138.192.229.404.188.644-.079.469-.306.85-.69 1.132-.054.04-.106.083-.161.122a.243.243 0 00-.103.245.77.77 0 00.055.195c.083.196.22.35.375.492.083.076.159.164.222.257a.37.37 0 01.025.377c-.023.05-.05.099-.076.148-.03.06-.028.111.022.162.041.042.08.089.112.138.038.058.078.079.147.05a.486.486 0 01.333-.006c.16.046.302.126.444.21.13.077.264.149.4.219.067.035.14.05.219.026.071-.022.124.01.145.076.02.064-.003.108-.074.139-.07.03-.137.063-.209.088-.1.035-.201.073-.314.077-.013-.107.11-.088.127-.159-.206-.126-.643-.145-.801-.034.063.112.035.21-.096.313-.13-.1-.025-.202.002-.3a.209.209 0 00-.249.17c-.015.101.067.216.178.224.108.007.218-.005.326-.012.06-.005.12-.027.199 0-.103.123-.248.127-.357.19.002.05.07.086.019.131-.053.048-.095-.001-.132-.03-.08-.063-.16-.126-.231-.197a.474.474 0 01-.157-.311.52.52 0 00-.043-.172c-.032-.074-.032-.137.033-.19-.018-.03-.028-.053-.045-.072a1.222 1.222 0 01-.196-.369c-.053-.137-.046-.264.048-.381.024-.03.05-.06.064-.095a.664.664 0 00.047-.168c.017-.165-.064-.287-.182-.387-.186-.156-.36-.322-.46-.551-.005-.011-.024-.017-.037-.026-.011.017-.024.027-.025.038-.019.185-.045.37-.052.557-.014.377.058.743.162 1.104.118.41.289.798.488 1.173.267.502.537 1.002.812 1.5.055.098.13.189.208.27.198.202.452.272.724.273.202 0 .404-.006.605-.026.295-.03.59-.073.884-.113.183-.025.365-.057.548-.08.21-.026.38.073.522.21.16.156.305.327.447.5.22.265.397.56.554.867.05.098.07.1.147.03.13-.121.26-.242.394-.36.067-.059.088-.12.067-.213a3.535 3.535 0 01-.085-.796c.002-.157.006-.314.018-.471.015-.224.03-.45.06-.672a59.114 59.114 0 01.362-2.298c.087-.493.182-.984.268-1.477.06-.347.118-.694.162-1.043.034-.273.055-.55.063-.825.011-.332.003-.665.002-.998 0-.077.004-.155-.01-.23-.028-.142-.01-.155-.162-.19a5.826 5.826 0 00-.607-.107c-.146-.018-.207-.053-.221-.19-.006-.049-.025-.098-.041-.146-.009-.025-.024-.048-.046-.09l-.025.264c-.009.096-.029.116-.127.115-.055 0-.11-.008-.164-.008-.476 0-.952-.008-1.426.032-.095.008-.173-.015-.226-.103-.04-.066-.088-.126-.134-.186-.063-.084-.086-.093-.182-.06-.195.068-.388.138-.582.21a2.71 2.71 0 00-.675.394.986.986 0 01-.323.168c-.033.01-.07.008-.127.013.02-.066.024-.114.047-.15.064-.105.135-.205.205-.306.023-.033.049-.063.073-.095l-.015-.023-.201.037c-.146.04-.296.07-.437.122-.148.053-.266.023-.386-.072a3.623 3.623 0 01-.733-.786l-.093-.132zm8.592 8.963l-.147.09c-.22.134-.44.266-.659.402-.093.058-.184.12-.27.188-.085.07-.124.161-.072.272.047.1.093.2.147.294.047.08.124.138.213.147.11.01.228.012.336-.012.217-.05.372-.205.528-.357a.291.291 0 00.087-.308c-.046-.18-.079-.365-.118-.547-.011-.052-.027-.103-.045-.169zm-.257-2.409c-.12.291-.205.597-.325.91-.151.433-.294.87-.435 1.323.036-.01.054-.01.067-.018.261-.16.522-.324.785-.484.054-.033.071-.078.065-.138-.012-.13-.024-.262-.034-.393l-.068-.886c-.008-.103-.02-.206-.029-.31-.009 0-.017-.002-.026-.004zm3.081-8.13l.099.285c.08.231.159.463.24.714l.58 1.952c.187.63.372 1.262.558 1.893.114.382.235.762.343 1.146.072.257.126.519.186.799.044.206.087.413.127.64.034.106.023.226.077.325l.025-.006-.068-.362c-.038-.206-.077-.412-.113-.638-.015-.07-.029-.141-.046-.211-.095-.396-.177-.796-.29-1.187-.196-.685-.413-1.364-.618-2.046-.165-.549-.322-1.1-.488-1.648-.069-.227-.15-.45-.226-.695l-.117-.336c-.037-.107-.075-.216-.115-.322-.04-.106-.084-.21-.127-.314a7.558 7.558 0 01-.027.01zM6.225 14.304c-.063-.001-.115.014-.134.083a.35.35 0 00.41.012 4.533 4.533 0 00-.276-.095zM5.23 11.98c-.026-.027-.057-.048-.075.002-.012.032-.007.07-.01.113.082-.037.082-.037.085-.115zm.062-1.189a.135.135 0 00-.088.056.197.197 0 00-.025.11c.005.152.01.306.026.457a.751.751 0 00.066.218c.061.136.157.167.288.101.055-.027.06-.054.025-.11a4.52 4.52 0 01-.129-.211c-.015-.068-.066-.131-.033-.207.04-.09-.076-.116-.074-.19V10.874c-.003-.038-.006-.087-.056-.083zm-.017-.968a.867.867 0 00-.467.127c-.076.045-.084.07-.05.158.034.087.07.173.115.254.064.117.09.125.21.077a.657.657 0 01.336-.053c.202.022.357.136.504.264l.092.077c.007-.006.014-.013.022-.018-.019-.105-.035-.226-.149-.264-.157-.053-.324-.075-.508-.117l-.24-.005c.24-.169.452-.044.687.009-.063-.115-.153-.147-.23-.193-.082-.05-.17-.092-.25-.144-.06-.037-.12-.08-.072-.172zm10.233.325c-.23-.01-.427.08-.608.211-.034.026-.06.065-.105.117.087.026.15.046.232.065.044-.015.088-.03.13-.046.306-.114.61-.115.904.031.126.063.237.04.366-.005-.02-.031-.03-.054-.045-.071a.986.986 0 00-.448-.273c-.14-.044-.284-.024-.426-.03zM7.99 6.483a.308.308 0 00.002.133c.08.321.156.643.242.962.104.387.27.75.456 1.103.02.037.061.08.098.087a.404.404 0 00.253-.051l-.472-.84c-.23-.448-.405-.92-.579-1.394zM10.397.497c-.2-.008-.405.004-.603.034-.236.035-.47.087-.7.152-.287.08-.569.18-.852.273-.04.013-.074.038-.11.058.028.014.05.018.07.014.287-.068.58-.085.873-.09.134-.002.269.009.402.025.19.024.382.048.57.09.456.104.874.3 1.265.556.464.306.888.66 1.257 1.078.205.232.395.475.56.739.17.274.315.561.449.856.273.601.456 1.232.6 1.876.04.173.07.348.1.524.017.104.065.167.17.19.122.028.2.105.22.251-.003.102-.06.174-.129.24a1.065 1.065 0 00-.268.358.164.164 0 00.083-.039c.08-.086.162-.172.235-.265a.56.56 0 00.13-.333c.009-.05.022-.1.024-.15.007-.124-.017-.15-.143-.168-.025-.004-.049-.014-.073-.015-.082-.007-.125-.063-.137-.131-.033-.198-.004-.355.247-.408.086-.018.174-.03.26-.042.158-.023.315-.053.473-.067.14-.012.19.033.226.167.008.029.018.057.021.087.019.179-.008.225-.141.288-.027.013-.055.024-.078.042a.148.148 0 00-.051.067c-.039.144.073.382.206.445l.673.32c.023.011.05.015.075.023l.018-.026c-.015-.008-.032-.013-.044-.024a2.27 2.27 0 00-.544-.32 4.898 4.898 0 00-.173-.075.203.203 0 01-.126-.191c-.003-.085.045-.154.128-.187l.059-.025c.099-.044.118-.076.112-.187a.384.384 0 00-.008-.063c-.067-.294-.123-.59-.205-.88a9.478 9.478 0 00-.826-2.036 7.465 7.465 0 00-1.39-1.805 4.536 4.536 0 00-1.177-.824 3.656 3.656 0 00-1.016-.328 6.155 6.155 0 00-.712-.074zm6.719 5.955c.01.014.018.028.038.034l-.022-.044-.016.01zM4.103 3.917a.062.062 0 01-.03.012.455.455 0 01-.04.039c-.01.01-.02.02-.045.04l-.363.354c-.088.085-.17.178-.266.253-.284.22-.425.53-.544.855a.132.132 0 00-.007.071c.013.055.033.108.052.168l.074.026c-.017.056-.03.105-.047.152-.058.164-.118.327-.175.491-.005.015.008.036.019.077.08-.175.158-.33.225-.489.228-.544.484-1.074.819-1.561.09-.133.182-.266.283-.401.004-.006.007-.013.022-.03.001-.016.003-.032.015-.04l.008-.017zm12.976 2.408a.023.023 0 01.009.019.073.073 0 00-.006.01.188.188 0 00.007.02l.018.022c.002-.007.007-.016.005-.021-.003-.01-.012-.018-.02-.038a1.331 1.331 0 01-.013-.012zM4.199 4.48c-.003.004-.008.008-.027.014-.005.013-.011.025-.031.047a2.085 2.085 0 01-.124.167c-.048.07-.116.055-.181.041-.134-.028-.228.016-.287.143-.089.187-.187.37-.273.56-.049.108-.11.216-.118.36.081.003.154.007.228.008h.228a2.563 2.563 0 01-.079.264c-.01.052-.022.103-.033.155l.02.004c.018-.046.037-.092.067-.153.066-.142.13-.285.2-.426.02-.04.034-.1.116-.092 0 .043.004.084 0 .124-.005.045-.017.09-.028.143.141.043.086.174.115.269.102-.022.104-.195.248-.144v.205l.017.002.439-1.059c-.13 0-.246-.02-.358.033-.024.011-.058-.001-.108-.004.075-.15.139-.278.211-.417a.128.128 0 01.025-.036c0-.015-.001-.03.008-.038l.006-.02c-.005.006-.01.011-.028.017-.004.012-.009.024-.026.045a.085.085 0 01-.032.033c-.123.157-.09.164-.258.106-.079-.027-.078-.028-.047-.144.028-.046.056-.093.098-.15 0-.016-.001-.032.007-.042L4.2 4.48zm2.073-.67c-.003.006-.007.011-.027.016-.094.125-.194.246-.28.377-.155.238-.301.481-.451.723-.14.224-.345.368-.575.481-.017.008-.04.006-.079.011.012-.059.016-.109.033-.153a6.076 6.076 0 01.229-.518l-.007-.02a.138.138 0 01-.035.025c-.028.05-.055.1-.093.164-.26.424-.443.817-.442.95.024.004.048.011.073.013.177.013.188.007.26-.165.03-.07.077-.12.147-.15l.175-.07c.044-.018.085-.057.146-.032.003.05-.01.11.014.145.042.062.044.125.047.193.002.049.017.098.026.147.029-.034.039-.065.05-.097.142-.39.277-.782.428-1.17.1-.256.22-.504.33-.756.013-.03.013-.067.03-.092V3.81zm3.987-.34c0 .045.01.084.021.123.042.16.094.318.124.48.024.133.023.27.028.406 0 .033-.019.067-.032.11-.094-.058-.047-.158-.106-.215h-.125c-.015.072-.01.152-.046.2-.066.085-.155.154-.236.227-.043.038-.078.018-.103-.025l-.046-.087c-.065.035-.117.069-.172.093-.116.051-.235.095-.35.147-.085.038-.09.053-.07.147.014.075.034.148.047.223.013.072.05.109.123.124.233.05.462.115.657.265.058-.102.058-.102.168-.151.03-.014.06-.03.092-.042.08-.03.115-.017.15.06.023.048.041.098.066.158.06-.14-.042-.267.017-.416.157.18.24.39.375.567a.235.235 0 00.022-.098c.002-.124 0-.247.002-.371 0-.034.013-.067.02-.1l.032-.003c.11.155.13.354.226.52a3.036 3.036 0 00-.01-.392c-.004-.045 0-.074.05-.088.08.036.116.14.215.158-.03-.275-.423-1.137-.798-1.635-.114-.127-.2-.28-.34-.386zm-2.667.696c-.019.034-.03.05-.037.067-.061.185-.125.37-.18.556-.031.105-.087.169-.195.19-.09.019-.178.052-.268.073-.038.009-.089.015-.118-.003-.024-.016-.025-.069-.036-.106-.064.076-.082.087-.17.047-.133-.062-.262-.135-.393-.201-.048-.025-.093-.063-.17-.03-.043.12-.091.25-.137.382-.099.28-.087.242.095.453.046.048.102.03.154.023.054-.009.106-.03.16-.036.13-.013.26-.08.367-.015.204-.064.387-.122.571-.178.05-.015.089.005.114.054.022.042.034.093.082.121.038-.056-.013-.128.063-.178l.14.241-.042-1.46zm.278.358c-.096-.01-.107.01-.11.108-.002.038-.003.078.002.115.03.2.099.386.174.57.002.006.012.01.022.015l.078-.05c.052.036.081.088.153.088.205-.002.41.014.616.012.099-.001.158.042.205.12.018.03.024.077.088.066l-.08-.394c-.05-.195-.085-.395-.172-.589-.057.057-.114.068-.18.046a.72.72 0 00-.135-.028c-.22-.028-.44-.059-.66-.08zm10.254-1.727c.089.163.155.316.139.491-.016.168.026.342-.044.516-.047-.033-.088-.082-.112-.075-.117.035-.164-.057-.227-.115a4.772 4.772 0 01-.286-.29l-.104-.113a4.856 4.856 0 01-.023.019c.035.046.07.093.11.156.04.064.084.127.122.193.034.058.065.118.031.205-.082-.01-.164-.019-.246-.032-.06-.01-.101 0-.124.07-.031.098-.037.096-.15.09.02.042.036.08.057.116.041.074.03.138-.03.196-.06.06-.118.122-.178.181a.175.175 0 01-.185.046c-.222-.061-.447-.113-.67-.174-.032-.009-.063-.04-.086-.068-.03-.04-.052-.087-.08-.13-.044-.07-.09-.138-.136-.207a.18.18 0 00-.014.105c.012.127.03.253.035.38.005.1-.024.12-.121.104-.104-.017-.206-.04-.31-.058-.064-.012-.131-.028-.202.03l.081.208c.09 0 .166-.01.237.002a.819.819 0 01.458.251c.078.083.154.168.241.26l.018-.005c-.004-.006-.008-.013-.01-.04.014-.056-.062-.118.018-.178.031.03.064.057.088.09.058.078.111.159.169.257l.089.141.024-.013a2093.819 2093.819 0 01-.427-.934c.055.007.083.007.108.016.193.07.385.142.577.216.074.028.147.06.219.094.062.028.112.018.157-.033.05-.056.102-.112.154-.167.05-.051.095-.046.132.014.016.025.026.053.04.08.071.138.143.277.217.433l.159.308.025-.011c-.044-.106-.07-.218-.138-.334-.057-.182-.168-.346-.206-.545.136.034.362.326.567.732l.057.074.018-.011a1.563 1.563 0 01-.052-.127c-.046-.145-.097-.29-.136-.436-.022-.083-.036-.173.022-.26l.109.058-.026-.207.027-.016c.022.02.05.036.065.06.073.108.143.22.215.33.01.016.029.029.043.043-.036-.217-.2-.38-.229-.626l.155.112c.014-.166.012-.319.042-.465.032-.158-.023-.297-.063-.445.024.004.036.006.055.025.092.124.183.249.277.371.02.027.05.047.069.087l.04.063.019-.015a.293.293 0 01-.053-.082 27.922 27.922 0 01-.332-.49c-.221-.311-.363-.467-.485-.521zm-6.57.327c-.003.161.092.275.069.415l-.368.087c.09.139.032.237-.052.331-.05.057-.092.122-.143.178-.037.04-.046.078-.018.126l.16.275c.029.048.072.066.128.064.076-.003.152 0 .228-.001.116-.003.216.022.275.137.006.014.02.024.044.052.004-.059-.003-.098.01-.13.016-.04.04-.099.072-.108.084-.023.173-.024.26-.03.013-.001.027.018.04.029l.071.065c.019-.11-.082-.198-.024-.31l.126.04c-.026-.123-.07-.245-.071-.366 0-.123.051-.243.115-.36.107.062.16.156.234.253.183.265.36.533.494.834.165-.078.27.068.407.088-.003-.106-.133-.441-.197-.492a.142.142 0 00-.102-.028c-.06.011-.119.039-.191.063-.025-.039-.056-.078-.077-.122a3.936 3.936 0 00-.473-.783c-.076-.094-.16-.182-.228-.26l-.391.285c-.049.035-.094.03-.132-.017l-.169-.207c-.025-.03-.053-.059-.097-.108z"+ ></path>+ </svg>+ );+}diff --git a/packages/app/src/components/icons/openclaw.tsx b/packages/app/src/components/icons/openclaw.tsxnew file mode 100644index 000000000..83c46b391--- /dev/null+++ b/packages/app/src/components/icons/openclaw.tsx@@ -0,0 +1,50 @@+import type { SVGProps } from 'react';++// OpenClaw brand mark: a smooth vector lobster, flattened to a single `currentColor`+// silhouette so it tracks the dropdown row's text color and brightens on hover like+// every other brand icon. Antennae are currentColor strokes; the two eyes are punched+// out via a mask so the mark reads as a creature instead of a solid blob.+export function OpenClawIcon(props: SVGProps<SVGSVGElement>) {+ return (+ <svg+ role="img"+ aria-label="OpenClaw icon"+ xmlns="http://www.w3.org/2000/svg"+ width={24}+ height={24}+ fill="none"+ viewBox="0 0 120 120"+ {...props}+ >+ <title>OpenClaw icon</title>+ <mask id="openclaw-eyes" maskUnits="userSpaceOnUse" x={0} y={0} width={120} height={120}>+ <rect width={120} height={120} fill="white" />+ <circle cx={45} cy={35} r={6} fill="black" />+ <circle cx={75} cy={35} r={6} fill="black" />+ </mask>+ <g fill="currentColor" mask="url(#openclaw-eyes)">+ {/* body */}+ <path d="M60 10 C30 10 15 35 15 55 C15 75 30 95 45 100 L45 110 L55 110 L55 100 C55 100 60 102 65 100 L65 110 L75 110 L75 100 C90 95 105 75 105 55 C105 35 90 10 60 10Z" />+ {/* left claw */}+ <path d="M20 45 C5 40 0 50 5 60 C10 70 20 65 25 55 C28 48 25 45 20 45Z" />+ {/* right claw */}+ <path d="M100 45 C115 40 120 50 115 60 C110 70 100 65 95 55 C92 48 95 45 100 45Z" />+ </g>+ {/* antennae */}+ <path+ d="M45 15 Q35 5 30 8"+ fill="none"+ stroke="currentColor"+ strokeWidth={3}+ strokeLinecap="round"+ />+ <path+ d="M75 15 Q85 5 90 8"+ fill="none"+ stroke="currentColor"+ strokeWidth={3}+ strokeLinecap="round"+ />+ </svg>+ );+}diff --git a/packages/app/src/lib/handoff/dispatch.ts b/packages/app/src/lib/handoff/dispatch.tsindex c6b28988e..929ff9f18 100644--- a/packages/app/src/lib/handoff/dispatch.ts+++ b/packages/app/src/lib/handoff/dispatch.ts@@ -148,6 +148,20 @@ export async function dispatchHandoff(reason: 'invalid-payload',detail: 'antigravity is terminal-only; launch via requestTerminalLaunch',};+ case 'openclaw':+ // Terminal-only target (`openclaw chat` CLI), same carve-out as above.+ return {+ ok: false,+ reason: 'invalid-payload',+ detail: 'openclaw is terminal-only; launch via requestTerminalLaunch',+ };+ case 'hermes':+ // Terminal-only target (`hermes chat` CLI), same carve-out as above.+ return {+ ok: false,+ reason: 'invalid-payload',+ detail: 'hermes is terminal-only; launch via requestTerminalLaunch',+ };default: {const _exhaustive: never = payload.target;return {diff --git a/packages/app/src/lib/handoff/targets.test.ts b/packages/app/src/lib/handoff/targets.test.tsindex 302fff933..905f97078 100644--- a/packages/app/src/lib/handoff/targets.test.ts+++ b/packages/app/src/lib/handoff/targets.test.ts@@ -2,8 +2,8 @@ import { describe, expect, test } from 'bun:test';import { KNOWN_TARGETS, VISIBLE_TARGETS } from './targets.ts';describe('KNOWN_TARGETS', () => {- test('has exactly eight targets (four GUI + terminal-only Copilot, OpenCode, Pi, Antigravity)', () => {- expect(KNOWN_TARGETS.length).toBe(8);+ test('has exactly ten targets (four GUI + terminal-only Copilot, OpenCode, Pi, Antigravity, OpenClaw, Hermes)', () => {+ expect(KNOWN_TARGETS.length).toBe(10);});test('ids cover the full HandoffTarget union', () => {@@ -18,19 +18,16 @@ describe('KNOWN_TARGETS', () => {'opencode','pi','antigravity',+ 'openclaw',+ 'hermes',]),);});- test('copilot, opencode, pi, and antigravity are terminal-only — no URL scheme', () => {- const copilot = KNOWN_TARGETS.find((t) => t.id === 'copilot');- expect(copilot?.schemes).toEqual([]);- const opencode = KNOWN_TARGETS.find((t) => t.id === 'opencode');- expect(opencode?.schemes).toEqual([]);- const pi = KNOWN_TARGETS.find((t) => t.id === 'pi');- expect(pi?.schemes).toEqual([]);- const antigravity = KNOWN_TARGETS.find((t) => t.id === 'antigravity');- expect(antigravity?.schemes).toEqual([]);+ test('copilot, opencode, pi, antigravity, openclaw, and hermes are terminal-only — no URL scheme', () => {+ for (const id of ['copilot', 'opencode', 'pi', 'antigravity', 'openclaw', 'hermes'] as const) {+ expect(KNOWN_TARGETS.find((t) => t.id === id)?.schemes).toEqual([]);+ }});test('claude-cowork + claude-code share the claude: scheme (single install state)', () => {@@ -63,6 +60,8 @@ describe('KNOWN_TARGETS', () => {expect(byId.get('opencode')).toBe('OpenCode');expect(byId.get('pi')).toBe('Pi');expect(byId.get('antigravity')).toBe('Antigravity');+ expect(byId.get('openclaw')).toBe('OpenClaw');+ expect(byId.get('hermes')).toBe('Hermes');});});@@ -77,15 +76,13 @@ describe('VISIBLE_TARGETS (UI render allow-list)', () => {expect(ids.has('claude-cowork')).toBe(false);});- test('hides the terminal-only copilot + opencode + pi + antigravity targets from the GUI deep-link list', () => {- // Copilot, OpenCode, Pi, and Antigravity surface as terminal-CLI launch rows- // (TERMINAL_CLI_IDS), not GUI deep-link targets, so they must not appear in- // VISIBLE_TARGETS.+ test('hides every terminal-only target (copilot/opencode/pi/antigravity/openclaw/hermes) from the GUI deep-link list', () => {+ // These surface as terminal-CLI launch rows (TERMINAL_CLI_IDS), not GUI+ // deep-link targets, so they must not appear in VISIBLE_TARGETS.const ids = new Set(VISIBLE_TARGETS.map((t) => t.id));- expect(ids.has('copilot')).toBe(false);- expect(ids.has('opencode')).toBe(false);- expect(ids.has('pi')).toBe(false);- expect(ids.has('antigravity')).toBe(false);+ for (const id of ['copilot', 'opencode', 'pi', 'antigravity', 'openclaw', 'hermes'] as const) {+ expect(ids.has(id)).toBe(false);+ }});test('keeps the remaining three targets visible', () => {diff --git a/packages/app/src/lib/handoff/targets.ts b/packages/app/src/lib/handoff/targets.tsindex 61f954db2..2852aacd8 100644--- a/packages/app/src/lib/handoff/targets.ts+++ b/packages/app/src/lib/handoff/targets.ts@@ -89,6 +89,24 @@ export const KNOWN_TARGETS = [installUrl: 'https://antigravity.google',tagline: "Google's agentic IDE + `agy` terminal agent.",},+ {+ // Terminal-only target, same carve-out as above. Reached via the+ // `openclaw chat` CLI launch row; the gateway/app are not deep-link targets.+ id: 'openclaw',+ displayName: 'OpenClaw',+ schemes: [],+ installUrl: 'https://openclaw.ai',+ tagline: 'Open-source agent gateway; runs agents against your MCP servers.',+ },+ {+ // Terminal-only target, same carve-out as above. Reached via the+ // `hermes chat` CLI launch row.+ id: 'hermes',+ displayName: 'Hermes',+ schemes: [],+ installUrl: 'https://hermes-agent.nousresearch.com',+ tagline: "Nous Research's terminal coding agent.",+ },] as const satisfies ReadonlyArray<TargetData>;// UI-visibility allow-list. `claude-cowork` is intentionally absent: dispatch@@ -98,13 +116,15 @@ export const KNOWN_TARGETS = [// group, and the empty-state "Create with <agent>" composer.export const VISIBLE_TARGETS: ReadonlyArray<TargetData> = KNOWN_TARGETS.filter(// `claude-cowork`: dispatch-by-ID only, no render surface.- // `copilot` / `opencode` / `pi` / `antigravity`: terminal-only — surfaced via the- // terminal-CLI rows, not the GUI deep-link target list, so they must not- // appear as dispatchable rows.+ // `copilot` / `opencode` / `pi` / `antigravity` / `openclaw` / `hermes`:+ // terminal-only — surfaced via the terminal-CLI rows, not the GUI deep-link+ // target list, so they must not appear as dispatchable rows.(target) =>target.id !== 'claude-cowork' &&target.id !== 'copilot' &&target.id !== 'opencode' &&target.id !== 'pi' &&- target.id !== 'antigravity',+ target.id !== 'antigravity' &&+ target.id !== 'openclaw' &&+ target.id !== 'hermes',);diff --git a/packages/app/tests/stress/fixtures/handoff-mocks.ts b/packages/app/tests/stress/fixtures/handoff-mocks.tsindex eadf4457c..9422187ab 100644--- a/packages/app/tests/stress/fixtures/handoff-mocks.ts+++ b/packages/app/tests/stress/fixtures/handoff-mocks.ts@@ -617,6 +617,8 @@ export async function installHandoffMocks(page: Page, cfg: HandoffMockConfig): Pcursor: true,pi: true,antigravity: true,+ openclaw: true,+ hermes: true,}),rewireClaudeMcp: async () => ({ claude: 'present' as const, mcp: 'wired' as const }),},diff --git a/packages/core/src/handoff/index.ts b/packages/core/src/handoff/index.tsindex 5c65c0abb..6328a5f3c 100644--- a/packages/core/src/handoff/index.ts+++ b/packages/core/src/handoff/index.ts@@ -35,8 +35,10 @@ export {buildClaudeLaunchCommand,buildCliLaunchArgString,buildCliLaunchCommand,+ buildStartupInjectionBytes,OK_GATED_TOOL_NAMES,shellSingleQuote,+ startupInjectionFor,TERMINAL_CLI_IDS,TERMINAL_CLIS,type TerminalCli,diff --git a/packages/core/src/handoff/terminal-launch.test.ts b/packages/core/src/handoff/terminal-launch.test.tsindex 84e7ae295..0113c3ec7 100644--- a/packages/core/src/handoff/terminal-launch.test.ts+++ b/packages/core/src/handoff/terminal-launch.test.ts@@ -4,8 +4,10 @@ import {buildClaudeLaunchCommand,buildCliLaunchArgString,buildCliLaunchCommand,+ buildStartupInjectionBytes,OK_GATED_TOOL_NAMES,shellSingleQuote,+ startupInjectionFor,TERMINAL_CLI_IDS,TERMINAL_CLIS,} from './terminal-launch.ts';@@ -18,7 +20,7 @@ const OK_ALLOW = `["mcp__${MCP_SERVER_NAME}","Bash(ok open:*)"]`;const OK_DENY = `["mcp__${MCP_SERVER_NAME}__delete","mcp__${MCP_SERVER_NAME}__move","mcp__${MCP_SERVER_NAME}__share_link","mcp__${MCP_SERVER_NAME}__install"]`;describe('TERMINAL_CLI_IDS', () => {- it('lists the CLIs in auto-pick priority order (claude > codex > opencode > cursor > copilot > pi > antigravity)', () => {+ it('lists the CLIs in auto-pick priority order (claude > codex > opencode > cursor > copilot > pi > antigravity > openclaw > hermes)', () => {// The single constant drives both the visible launch-row order and the// default-CLI auto-pick, so display and defaulting can never disagree.expect([...TERMINAL_CLI_IDS]).toEqual([@@ -29,6 +31,8 @@ describe('TERMINAL_CLI_IDS', () => {'copilot','pi','antigravity',+ 'openclaw',+ 'hermes',]);});});@@ -131,10 +135,21 @@ describe('buildCliLaunchCommand', () => {// Antigravity's CLI binary is `agy`; it has no positional prompt, so the// prompt rides on --prompt-interactive (keeps the session interactive).expect(buildCliLaunchCommand('antigravity', 'hi')).toBe("agy --prompt-interactive 'hi'\r");+ // OpenClaw's interactive TUI is `openclaw chat`; its initial message rides on+ // `--message` (the positional isn't the prompt).+ expect(buildCliLaunchCommand('openclaw', 'hi')).toBe("openclaw chat --message 'hi'\r");+ // Hermes takes NO starting-prompt argument — `hermes chat` launches promptless+ // and the prompt is PTY-injected (see buildStartupInjectionBytes), so the argv+ // never carries it regardless of the prompt passed.+ expect(buildCliLaunchCommand('hermes', 'hi')).toBe('hermes chat\r');});- it('escapes the prompt identically for every CLI regardless of fixed args', () => {+ it('escapes the prompt identically for every argv-prompt CLI regardless of fixed args', () => {for (const cli of TERMINAL_CLI_IDS) {+ // Injection CLIs (Hermes) deliver the prompt out-of-band, not on the argv —+ // their command is the promptless `<bin> <subcommand>`, so the "prompt is the+ // final escaped arg" invariant doesn't apply. Covered by the injection tests.+ if (startupInjectionFor(cli) != null) continue;const cmd = buildCliLaunchCommand(cli, "'; rm -rf / #", { mcpPreApprove: true });// Whatever fixed args precede it, the prompt is the final, escaped arg.expect(cmd.startsWith(`${TERMINAL_CLIS[cli].bin} `)).toBe(true);@@ -169,6 +184,11 @@ describe('buildCliLaunchArgString', () => {expect(buildCliLaunchArgString('opencode', 'hi')).toBe("opencode --prompt 'hi'");expect(buildCliLaunchArgString('pi', 'hi')).toBe("pi 'hi'");expect(buildCliLaunchArgString('antigravity', 'hi')).toBe("agy --prompt-interactive 'hi'");+ // OpenClaw: fixed `chat` subcommand + `--message` prompt flag.+ expect(buildCliLaunchArgString('openclaw', 'hi')).toBe("openclaw chat --message 'hi'");+ // Hermes: injection CLI — the prompt is dropped from the argv (delivered by a+ // post-launch PTY paste), leaving the promptless `hermes chat` shape.+ expect(buildCliLaunchArgString('hermes', 'hi')).toBe('hermes chat');});it('keeps an injection payload inert and contained in the prompt arg', () => {@@ -188,6 +208,10 @@ describe('buildCliLaunchArgString promptless (New chat)', () => {// OpenCode carries a prompt on `--prompt`; with no prompt the flag is// dropped entirely so the bare TUI opens (positional stays the cwd).expect(buildCliLaunchArgString('opencode', emptyPrompt)).toBe('opencode');+ // The fixed `chat` subcommand survives a promptless launch (bare `openclaw`/+ // `hermes` isn't the interactive TUI); only the `--message` flag is dropped.+ expect(buildCliLaunchArgString('openclaw', emptyPrompt)).toBe('openclaw chat');+ expect(buildCliLaunchArgString('hermes', emptyPrompt)).toBe('hermes chat');}});@@ -231,6 +255,61 @@ describe('buildCliLaunchArgString promptless (New chat)', () => {});});+describe('buildStartupInjectionBytes', () => {+ const START = '\x1b[200~';+ const END = '\x1b[201~';++ it('returns null for CLIs that carry the prompt on the argv (nothing to inject)', () => {+ for (const cli of TERMINAL_CLI_IDS) {+ if (startupInjectionFor(cli) != null) continue;+ expect(buildStartupInjectionBytes(cli, 'hi')).toBeNull();+ }+ });++ it('frames a Hermes prompt in bracketed paste + the registry submit byte', () => {+ // Bracketed paste (DEC 2004) makes the TUI treat the bytes as literal pasted+ // text, then `\r` submits the now-complete input.+ expect(buildStartupInjectionBytes('hermes', 'do the thing')).toBe(+ `${START}do the thing${END}\r`,+ );+ });++ it('keeps a multi-line prompt intact inside the paste frame (no early submit)', () => {+ // A bare newline in a TUI input box normally submits; inside bracketed paste it+ // is preserved, so the whole multi-line prompt lands as one input.+ const multi = 'line one\nline two\nline three';+ expect(buildStartupInjectionBytes('hermes', multi)).toBe(`${START}${multi}${END}\r`);+ });++ it('strips ESC so the prompt cannot terminate the paste frame or inject a sequence', () => {+ // A literal END sentinel (or any ESC) in the prompt would break out of the+ // paste; every ESC byte is removed, neutralizing the break-out.+ const hostile = `abc${END}rm -rf /\x1b[2J`;+ const bytes = buildStartupInjectionBytes('hermes', hostile);+ // Exactly one START and one END remain — the frame we added, not the payload's.+ expect(bytes).toBe(`${START}abc[201~rm -rf /[2J${END}\r`);+ expect(bytes?.split(START).length).toBe(2);+ expect(bytes?.split(END).length).toBe(2);+ });++ it('returns null for an empty/absent prompt (a promptless New-chat launch)', () => {+ for (const emptyPrompt of [null, undefined, ''] as const) {+ expect(buildStartupInjectionBytes('hermes', emptyPrompt)).toBeNull();+ }+ });++ it('Hermes waits on the DEC-2004 bracketed-paste-enable marker, with a cap beyond the debounce', () => {+ const cfg = startupInjectionFor('hermes');+ // Keying on the terminal-protocol escape (not UI prose) is what makes the+ // ready detection language- and version-stable; it's also the exact+ // precondition for the paste to be honored.+ expect(cfg?.readyMarker).toBe('\x1b[?2004h');+ // The cap fallback must sit strictly after the post-marker debounce so the+ // marker path wins on a normal boot and the cap only catches a missing marker.+ expect(cfg && cfg.capMs > cfg.settleMs).toBe(true);+ });+});+describe('claude MCP pre-approval', () => {it('is OFF by default and only added for claude when opted in', () => {expect(buildCliLaunchCommand('claude', 'hi')).not.toContain('--settings');diff --git a/packages/core/src/handoff/terminal-launch.ts b/packages/core/src/handoff/terminal-launch.tsindex 8bb93f829..002c639ef 100644--- a/packages/core/src/handoff/terminal-launch.ts+++ b/packages/core/src/handoff/terminal-launch.ts@@ -40,11 +40,18 @@ export function shellSingleQuote(s: string): string {}/**- * The agent CLIs the docked terminal can launch. Each starts an interactive- * session with the prompt as a single positional argument — the exact- * `<bin> '<prompt>'` parity of `claude '<prompt>'` (NOT the non-interactive- * one-shot variants: `codex exec` and `cursor-agent -p` both run-and-exit, so- * the session wouldn't stay open for the user to continue in).+ * The agent CLIs the docked terminal can launch. Each starts an INTERACTIVE+ * session that stays open with the composed prompt threaded in — NOT the+ * non-interactive one-shot variants (`codex exec`, `cursor-agent -p`,+ * `hermes -q`/`-z`) which run-and-exit before the user can continue.+ *+ * The prompt reaches the CLI three ways, per {@link TerminalCliInfo}:+ * - positional (`claude '<prompt>'`) — the default (no `promptFlag`);+ * - a flag (`opencode --prompt '<prompt>'`, `openclaw chat --message '<prompt>'`)+ * for CLIs whose positional isn't the prompt (`promptFlag`);+ * - post-launch PTY paste (`hermes`) for CLIs with NO starting-prompt argument+ * at all — the promptless `<bin>` is spawned and the prompt is bracketed-paste+ * injected once its TUI is ready (`startupInjection`).*/export type TerminalCli =| 'claude'@@ -53,7 +60,9 @@ export type TerminalCli =| 'cursor'| 'opencode'| 'pi'- | 'antigravity';+ | 'antigravity'+ | 'openclaw'+ | 'hermes';export interface TerminalCliInfo {/** PATH binary launched in the PTY. Interpolated (alongside any opted-in@@ -75,12 +84,46 @@ export interface TerminalCliInfo {* the deep-link path) and brand-icon rendering. Single source of truth so* the renderer doesn't re-declare a parallel `cli → HandoffTarget` map. */readonly handoffTarget: HandoffTarget;+ /** Fixed subcommand token inserted immediately after `<bin>`, present in BOTH+ * the prompted and promptless shapes (unlike {@link TerminalCliInfo.promptFlag},+ * which is dropped when there is no prompt). For CLIs whose interactive session+ * lives under a verb rather than the bare binary — `openclaw chat` /+ * `hermes chat` (bare `openclaw`/`hermes` is the gateway/other entry point, not+ * the interactive TUI). Registry-fixed, never user input. */+ readonly subcommand?: string;/** Flag that carries the starting prompt for CLIs whose POSITIONAL argument is- * NOT the prompt. OpenCode's positional is the project directory, so its- * prompt must be passed as `--prompt '<text>'`; claude/codex/cursor take the+ * NOT the prompt. OpenCode's positional is the project directory (`--prompt`),+ * OpenClaw's initial message rides on `--message`; claude/codex/cursor take the* prompt positionally (omit this). When set, {@link buildCliLaunchArgString}- * inserts it immediately before the quoted prompt. */+ * inserts it immediately before the quoted prompt. Mutually exclusive with+ * {@link TerminalCliInfo.startupInjection} (a CLI either takes an argv prompt or+ * is injected, never both). */readonly promptFlag?: string;+ /** Marks a CLI that accepts NO starting-prompt argument at all: its interactive+ * TUI must be launched promptless and the composed prompt delivered afterward as+ * a bracketed-paste PTY write (see {@link buildStartupInjectionBytes}). When set,+ * {@link buildCliLaunchArgString} omits the prompt from the argv.+ *+ * Fields:+ * - `submit`: byte(s) written after the paste to send it (`'\r'`).+ * - `readyMarker`: exact byte sequence in the PTY output that signals the input+ * widget is live and ready to receive a paste. Hermes emits `\x1b[?2004h`+ * (bracketed-paste enable) when its prompt mounts — verified on a real Hermes+ * at ~940ms warm-boot. Keying on the DEC-2004 escape (not UI prose) is+ * language- and version-stable, and it is the exact precondition for the paste+ * to be honored (no `?2004h` → bracketed paste wouldn't apply anyway). Omit to+ * fall back to a pure timer.+ * - `settleMs`: debounce AFTER the marker before injecting (or, when no+ * `readyMarker`, a fixed beat from spawn).+ * - `capMs`: hard cap — inject anyway this long after spawn if the marker never+ * appears (a future TUI that changed its ready signal), so a launch never+ * silently drops the prompt. */+ readonly startupInjection?: {+ readonly submit: string;+ readonly readyMarker?: string;+ readonly settleMs: number;+ readonly capMs: number;+ };}/**@@ -159,6 +202,32 @@ function buildClaudeSettingsArg(opts: BuildCliLaunchOptions): string {return `--settings ${shellSingleQuote(JSON.stringify(settings))}`;}+/**+ * xterm bracketed-paste framing (DEC private mode 2004). A TUI in bracketed-paste+ * mode treats bytes between these sentinels as literal pasted text — it does NOT+ * run them through its key handler, so newlines don't submit early, a leading `/`+ * doesn't open a slash-command menu, and `@`/`#` don't trigger mention pickers.+ * That is exactly what a multi-line composed prompt needs; the submit byte+ * ({@link TerminalCliInfo.startupInjection}.submit) is sent AFTER the closing+ * sentinel to send the now-complete input.+ */+const ESC = '\x1b';+const BRACKETED_PASTE_START = `${ESC}[200~`;+const BRACKETED_PASTE_END = `${ESC}[201~`;++/**+ * Hermes injection timing. Rather than a blind fixed beat, the launcher waits for+ * Hermes' input widget to signal ready by emitting `\x1b[?2004h` (bracketed-paste+ * enable), then debounces {@link HERMES_INJECT_DEBOUNCE_MS} before pasting. On a+ * real Hermes this marker lands ~940ms after `hermes chat` (warm) and the widget+ * accepts a bracketed paste cleanly right after. {@link HERMES_INJECT_CAP_MS} is+ * the hard fallback: inject anyway if the marker never appears (e.g. a future+ * Hermes that changed its ready signal), so the prompt is never silently dropped.+ */+const HERMES_READY_MARKER = '\x1b[?2004h';+const HERMES_INJECT_DEBOUNCE_MS = 300;+const HERMES_INJECT_CAP_MS = 4000;+/*** Static registry for each launchable CLI. Cursor's agent CLI binary is* `cursor-agent` (the `cursor` command opens the GUI editor, not the agent).@@ -227,6 +296,41 @@ export const TERMINAL_CLIS = {handoffTarget: 'antigravity',promptFlag: '--prompt-interactive',},+ openclaw: {+ // OpenClaw's interactive TUI is `openclaw chat` (an alias for `tui --local`,+ // the local embedded agent runtime — no separate gateway process needed). Its+ // starting prompt is NOT positional: it rides on `--message <text>` ("Send an+ // initial message after connecting"), so the launch is+ // `openclaw chat --message '<prompt>'`. Bare `openclaw` is the gateway CLI, not+ // a chat — hence the fixed `chat` subcommand on both the prompted and+ // promptless (New chat) shapes.+ bin: 'openclaw',+ subcommand: 'chat',+ displayName: 'OpenClaw',+ docsUrl: 'https://docs.openclaw.ai/cli/tui',+ handoffTarget: 'openclaw',+ promptFlag: '--message',+ },+ hermes: {+ // Hermes (Nous Research) has NO interactive-with-starting-prompt argument: its+ // only prompt-carrying modes (`hermes chat -q`, `hermes -z`) are one-shots that+ // run-and-exit, and bare `hermes chat` opens the TUI with no way to seed it. So+ // OK launches `hermes chat` promptless and delivers the composed prompt as a+ // bracketed-paste PTY write once the TUI is ready (`startupInjection`). Bare+ // `hermes` can drop into provider setup on first run — `chat` is the stable+ // interactive entry point.+ bin: 'hermes',+ subcommand: 'chat',+ displayName: 'Hermes',+ docsUrl: 'https://hermes-agent.nousresearch.com/docs/user-guide/cli',+ handoffTarget: 'hermes',+ startupInjection: {+ submit: '\r',+ readyMarker: HERMES_READY_MARKER,+ settleMs: HERMES_INJECT_DEBOUNCE_MS,+ capMs: HERMES_INJECT_CAP_MS,+ },+ },} as const satisfies Record<TerminalCli, TerminalCliInfo>;/**@@ -244,6 +348,8 @@ export const TERMINAL_CLI_IDS = ['copilot','pi','antigravity',+ 'openclaw',+ 'hermes',] as const satisfies readonly TerminalCli[];export interface BuildCliLaunchOptions {@@ -306,15 +412,21 @@ export function buildCliLaunchArgString(? info.autoApproveArg: '';const fixedPrefix = fixedArgs ? `${fixedArgs} ` : '';- // Promptless: emit a bare `<bin>` (plus any opted-in fixed args). `fixedPrefix`- // carries its own trailing separator space, redundant with nothing after it.- if (prompt == null || prompt.length === 0) {- return `${info.bin} ${fixedPrefix}`.trimEnd();+ // Fixed subcommand (e.g. `openclaw chat` / `hermes chat`), present in both the+ // prompted and promptless shapes.+ const sub = info.subcommand ? `${info.subcommand} ` : '';+ // Promptless — a bare `<bin> [subcommand] [fixed args]` (the "New chat" path) —+ // OR a `startupInjection` CLI, whose prompt is delivered by a post-launch PTY+ // paste (see buildStartupInjectionBytes), never the argv. `fixedPrefix`/`sub`+ // carry their own trailing separator space, redundant with nothing after them.+ if (info.startupInjection != null || prompt == null || prompt.length === 0) {+ return `${info.bin} ${sub}${fixedPrefix}`.trimEnd();}// CLIs whose positional arg isn't the prompt (e.g. OpenCode, whose positional- // is the project dir) carry it via a flag instead.+ // is the project dir; OpenClaw, whose initial message is `--message`) carry it+ // via a flag instead.const promptFlag = info.promptFlag ? `${info.promptFlag} ` : '';- return `${info.bin} ${fixedPrefix}${promptFlag}${shellSingleQuote(prompt)}`;+ return `${info.bin} ${sub}${fixedPrefix}${promptFlag}${shellSingleQuote(prompt)}`;}/**@@ -342,3 +454,43 @@ export function buildCliLaunchCommand(export function buildClaudeLaunchCommand(prompt: string, opts: BuildCliLaunchOptions = {}): string {return buildCliLaunchCommand('claude', prompt, opts);}++/**+ * Bytes to write into a freshly-launched {@link TerminalCliInfo.startupInjection}+ * CLI's PTY to deliver the starting prompt it cannot take on its argv (Hermes).+ * The prompt is wrapped in bracketed-paste sentinels — so the TUI treats it as+ * literal pasted text, keeping a multi-line prompt intact and inert to key+ * handling — then the registry submit byte is appended to send it.+ *+ * Returns `null` when the CLI has no `startupInjection` (its prompt rode on the+ * argv, nothing to inject) or the prompt is empty (a promptless New-chat launch).+ *+ * Any ESC byte (0x1b) in the prompt is stripped first: a text prompt never+ * legitimately contains one, and leaving it in would let the content terminate+ * the bracketed-paste frame early (a literal `ESC[201~`) or smuggle its own+ * control sequence into the TUI — the paste-time analogue of shell injection.+ * This is the only user-influenced portion; everything around it is registry-fixed.+ */+/**+ * The startup-injection descriptor for a CLI, or `undefined` when it delivers its+ * prompt on the argv. A typed accessor so consumers don't cast around the+ * `as const satisfies` registry's per-entry literal types (which drop optional+ * fields from members that don't set them).+ */+export function startupInjectionFor(cli: TerminalCli): TerminalCliInfo['startupInjection'] {+ const info: TerminalCliInfo = TERMINAL_CLIS[cli];+ return info.startupInjection;+}++export function buildStartupInjectionBytes(+ cli: TerminalCli,+ prompt: string | null | undefined,+): string | null {+ const injection = startupInjectionFor(cli);+ if (injection == null || prompt == null || prompt.length === 0) return null;+ // Strip ESC (0x1b) — the byte that would let the prompt terminate the paste+ // frame early or smuggle in a control sequence. A plain-string `replaceAll`+ // (not a regex) keeps the control char out of a RegExp literal.+ const safe = prompt.replaceAll(ESC, '');+ return `${BRACKETED_PASTE_START}${safe}${BRACKETED_PASTE_END}${injection.submit}`;+}diff --git a/packages/core/src/handoff/types.ts b/packages/core/src/handoff/types.tsindex 42f027c36..012dc8601 100644--- a/packages/core/src/handoff/types.ts+++ b/packages/core/src/handoff/types.ts@@ -3,10 +3,10 @@* pure type surface consumable from Electron main, renderer, and server.*/-// `copilot`, `opencode`, `pi`, and `antigravity` are TERMINAL-ONLY targets: OK-// reaches them via their CLIs, not a URL scheme / GUI app, so they-// are carved out of the deep-link dispatch path (no `RECIPES` recipe, no-// `dispatch.ts` URL case, excluded from `VISIBLE_TARGETS`). They are members of+// `copilot`, `opencode`, `pi`, `antigravity`, `openclaw`, and `hermes` are+// TERMINAL-ONLY targets: OK reaches them via their CLIs, not a URL scheme / GUI+// app, so they are carved out of the deep-link dispatch path (no `RECIPES` recipe,+// no `dispatch.ts` URL case, excluded from `VISIBLE_TARGETS`). They are members of// the union only so they can reuse the shared brand-icon + display-name// metadata that the terminal-CLI launch rows render. Reached exclusively via// `requestTerminalLaunch` / `TERMINAL_CLIS`, never `dispatchHandoff`.@@ -18,7 +18,9 @@ export type HandoffTarget =| 'cursor'| 'opencode'| 'pi'- | 'antigravity';+ | 'antigravity'+ | 'openclaw'+ | 'hermes';/*** Data carried from the UI to the URL builder. Minimal by construction: onlydiff --git a/packages/core/src/index.ts b/packages/core/src/index.tsindex 41a4cb215..a4e1c78b9 100644--- a/packages/core/src/index.ts+++ b/packages/core/src/index.ts@@ -389,6 +389,7 @@ export {buildCliLaunchCommand,buildCodexUrl,buildCursorUrl,+ buildStartupInjectionBytes,type ComposeSelection,type CreateScenario,composeAskProjectPrompt,@@ -417,6 +418,7 @@ export {OK_TERMINAL_SURFACE_PREAMBLE,type PromptTransport,shellSingleQuote,+ startupInjectionFor,type TargetData,TERMINAL_CLI_IDS,TERMINAL_CLIS,diff --git a/packages/desktop/tests/main/claude-readiness.test.ts b/packages/desktop/tests/main/claude-readiness.test.tsindex 24d8cd979..82b333f98 100644--- a/packages/desktop/tests/main/claude-readiness.test.ts+++ b/packages/desktop/tests/main/claude-readiness.test.ts@@ -312,6 +312,8 @@ describe('resolveCliInstalledMap', () => {cursor: 0,pi: 127,antigravity: 0,+ openclaw: 0,+ hermes: 127,};expect(await resolveCliInstalledMap({ probe: (cli) => Promise.resolve(codes[cli]) })).toEqual({claude: true,@@ -321,6 +323,8 @@ describe('resolveCliInstalledMap', () => {cursor: true,pi: false,antigravity: true,+ openclaw: true,+ hermes: false,});});@@ -336,6 +340,8 @@ describe('resolveCliInstalledMap', () => {cursor: true,pi: true,antigravity: true,+ openclaw: true,+ hermes: true,});});diff --git a/packages/server/src/handoff-dispatch-api.ts b/packages/server/src/handoff-dispatch-api.tsindex 93525f13a..2abb33653 100644--- a/packages/server/src/handoff-dispatch-api.ts+++ b/packages/server/src/handoff-dispatch-api.ts@@ -140,21 +140,24 @@ const RECIPES = {binaryName: 'cursor',urlScheme: 'cursor:',},- // `copilot`, `opencode`, `pi`, and `antigravity` are intentionally absent:- // terminal-only targets with no URL scheme, dispatched via the terminal-CLI- // path (`requestTerminalLaunch`), never this deep-link endpoint.+ // `copilot`, `opencode`, `pi`, `antigravity`, `openclaw`, and `hermes` are+ // intentionally absent: terminal-only targets with no URL scheme, dispatched via+ // the terminal-CLI path (`requestTerminalLaunch`), never this deep-link endpoint.} as const satisfies Record<- Exclude<HandoffTarget, 'copilot' | 'opencode' | 'pi' | 'antigravity'>,+ Exclude<HandoffTarget, 'copilot' | 'opencode' | 'pi' | 'antigravity' | 'openclaw' | 'hermes'>,Recipe>;// Narrowed to the URL-dispatchable subset: `RECIPES` omits the terminal-only-// `copilot` / `opencode` / `pi` / `antigravity` targets, so its keys (and the-// parsed `target`) exclude them, keeping the `RECIPES[target]` lookup below-// exhaustive at the type level.+// `copilot` / `opencode` / `pi` / `antigravity` / `openclaw` / `hermes` targets,+// so its keys (and the parsed `target`) exclude them, keeping the `RECIPES[target]`+// lookup below exhaustive at the type level.const TARGET_VALUES = Object.keys(RECIPES) as [- Exclude<HandoffTarget, 'copilot' | 'opencode' | 'pi' | 'antigravity'>,- ...Exclude<HandoffTarget, 'copilot' | 'opencode' | 'pi' | 'antigravity'>[],+ Exclude<HandoffTarget, 'copilot' | 'opencode' | 'pi' | 'antigravity' | 'openclaw' | 'hermes'>,+ ...Exclude<+ HandoffTarget,+ 'copilot' | 'opencode' | 'pi' | 'antigravity' | 'openclaw' | 'hermes'+ >[],];const HandoffRequestSchema = z.object({target: z.enum(TARGET_VALUES),