remo-cli 2.2.0rc10__tar.gz → 2.2.0rc12__tar.gz

{remo_cli-2.2.0rc10 → remo_cli-2.2.0rc12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: remo-cli
-Version: 2.2.0rc10
+Version: 2.2.0rc12
 Summary: Remote development environment CLI
 License-Expression: MIT
 License-File: LICENSE

{remo_cli-2.2.0rc10 → remo_cli-2.2.0rc12}/docs/web-session-interface.md

@@ -102,9 +102,10 @@ The SPA is a two-pane **web console**:
   row (or its `+` button) **adds** it to a responsive grid (1/2/3 columns by count). In a grid, **drag
   a tile's header onto another to swap their positions** — a window outline follows the cursor and the
   swap target shows a dashed outline (mouse or touch press-and-hold; keyboard-accessible via the
-  handle); the arrangement persists until the grid is rebuilt. In a grid, **hovering a tile focuses it**
-  (focus-follows-mouse) so keystrokes go where the pointer is — no click needed. The **◻** control solos
-  a tile; **Esc** collapses the grid back to the focused terminal;
+  handle); the arrangement persists until the grid is rebuilt. In a grid, **resting the pointer on a
+  tile focuses it** (focus-follows-mouse, with a short dwell so passing through tiles doesn't steal
+  focus) — keystrokes go where the pointer is, no click needed. The **◻** control solos a tile; **Esc**
+  collapses the grid back to the focused terminal;
   number keys **1–9** jump to the numbered sessions (⌘ 1–9 add to the grid). Hidden terminals stay
   connected and keep their scrollback. Each terminal header shows `provider · instance · region`
   (doubling as the drag handle), connection state, and a
@@ -115,6 +116,13 @@ The SPA is a two-pane **web console**:
   toggle fullscreen on the focused terminal; **Esc** exits it. Fullscreen is a presentation overlay: it
   never disturbs the single/grid layout underneath, so exiting returns to exactly where you were.
 
+**Clipboard & links.** Select text and press **⌘C** (macOS) / **Ctrl+Shift+C** (Linux/Windows), or click
+the **⧉ Copy** button that appears on selection, to copy to the system clipboard; bare **Ctrl+C** stays
+SIGINT. **Paste** with ⌘V / Ctrl+V. **http(s) URLs are clickable** and open in a new tab. Remote apps that
+emit **OSC 52** (e.g. Claude Code's copy-on-select) can write to the browser clipboard — best-effort: it
+must traverse Zellij and the browser must permit a gesture-less clipboard write. OSC 52 *reads* are denied
+(a remote app can never read your clipboard). Clipboard access needs a secure context (HTTPS or localhost).
+
 **Session-row glyphs** (also shown in the rail legend):
 
 | Glyph | Meaning |

{remo_cli-2.2.0rc10 → remo_cli-2.2.0rc12}/frontend/package-lock.json

@@ -13,8 +13,10 @@
         "@fontsource/ibm-plex-mono": "^5.2.7",
         "@fontsource/jetbrains-mono": "^5.2.8",
         "@fontsource/source-code-pro": "^5.2.7",
+        "@xterm/addon-clipboard": "^0.1.0",
         "@xterm/addon-fit": "^0.10.0",
         "@xterm/addon-ligatures": "^0.9.0",
+        "@xterm/addon-web-links": "^0.11.0",
         "@xterm/addon-webgl": "^0.18.0",
         "@xterm/xterm": "^5.5.0",
         "ghostty-web": "0.4.0",
@@ -1851,6 +1853,18 @@
         "url": "https://opencollective.com/vitest"
       }
     },
+    "node_modules/@xterm/addon-clipboard": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/@xterm/addon-clipboard/-/addon-clipboard-0.1.0.tgz",
+      "integrity": "sha512-zdoM7p53T5sv/HbRTyp4hY0kKmEQ3MZvAvEtiXqNIHc/JdpqwByCtsTaQF5DX2n4hYdXRPO4P/eOS0QEhX1nPw==",
+      "license": "MIT",
+      "dependencies": {
+        "js-base64": "^3.7.5"
+      },
+      "peerDependencies": {
+        "@xterm/xterm": "^5.4.0"
+      }
+    },
     "node_modules/@xterm/addon-fit": {
       "version": "0.10.0",
       "resolved": "https://registry.npmjs.org/@xterm/addon-fit/-/addon-fit-0.10.0.tgz",
@@ -1876,6 +1890,15 @@
         "@xterm/xterm": "^5.0.0"
       }
     },
+    "node_modules/@xterm/addon-web-links": {
+      "version": "0.11.0",
+      "resolved": "https://registry.npmjs.org/@xterm/addon-web-links/-/addon-web-links-0.11.0.tgz",
+      "integrity": "sha512-nIHQ38pQI+a5kXnRaTgwqSHnX7KE6+4SVoceompgHL26unAxdfP6IPqUTSYPQgSwM56hsElfoNrrW5V7BUED/Q==",
+      "license": "MIT",
+      "peerDependencies": {
+        "@xterm/xterm": "^5.0.0"
+      }
+    },
     "node_modules/@xterm/addon-webgl": {
       "version": "0.18.0",
       "resolved": "https://registry.npmjs.org/@xterm/addon-webgl/-/addon-webgl-0.18.0.tgz",
@@ -2611,6 +2634,12 @@
         "@pkgjs/parseargs": "^0.11.0"
       }
     },
+    "node_modules/js-base64": {
+      "version": "3.9.1",
+      "resolved": "https://registry.npmjs.org/js-base64/-/js-base64-3.9.1.tgz",
+      "integrity": "sha512-U73qptcvf/HIOauFOmqT3a0mDUp0MYlfd15oqoe9kqZt5XhiXVb+HG09sLvI9PQ9tZIBFS4nlErai8zbWazP0g==",
+      "license": "BSD-3-Clause"
+    },
     "node_modules/js-tokens": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",

{remo_cli-2.2.0rc10 → remo_cli-2.2.0rc12}/frontend/package.json

@@ -20,8 +20,10 @@
     "@fontsource/ibm-plex-mono": "^5.2.7",
     "@fontsource/jetbrains-mono": "^5.2.8",
     "@fontsource/source-code-pro": "^5.2.7",
+    "@xterm/addon-clipboard": "^0.1.0",
     "@xterm/addon-fit": "^0.10.0",
     "@xterm/addon-ligatures": "^0.9.0",
+    "@xterm/addon-web-links": "^0.11.0",
     "@xterm/addon-webgl": "^0.18.0",
     "@xterm/xterm": "^5.5.0",
     "ghostty-web": "0.4.0",

{remo_cli-2.2.0rc10 → remo_cli-2.2.0rc12}/frontend/src/components/TerminalCard.tsx

@@ -28,6 +28,9 @@ const DEFAULT_COLS = 80;
 const DEFAULT_ROWS = 24;
 /** How much to shrink the terminal font in a grid tile when "scale to fit". */
 const GRID_FIT_SCALE = 0.8;
+/** Focus-follows-mouse dwell: the pointer must REST on a tile this long before
+ * it takes focus, so passing through tiles (or a small drift) doesn't steal it. */
+const HOVER_FOCUS_DELAY_MS = 220;
 
 const STATE_LABELS: Record<TerminalConnectionState, string> = {
   connecting: "Connecting…",
@@ -119,10 +122,14 @@ export function TerminalCard({
   // (to skip redundant resize frames).
   const fitRafRef = useRef<number | null>(null);
   const lastSentDimsRef = useRef<{ cols: number; rows: number } | null>(null);
+  // Pending focus-follows-mouse dwell timer (cleared if the pointer leaves first).
+  const hoverTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
 
   const [connectionState, setConnectionState] = useState<TerminalConnectionState>("connecting");
   const [needsManualReconnect, setNeedsManualReconnect] = useState(false);
   const [error, setError] = useState<TypedError | null>(null);
+  const [hasSelection, setHasSelection] = useState(false);
+  const [copied, setCopied] = useState(false);
 
   // dnd-kit reorder: the tile is both a draggable (handle = header grip, below)
   // and a droppable (swap target). Disabled outside a reorderable grid. We use
@@ -247,6 +254,9 @@ export function TerminalCard({
       }
     });
 
+    // Show/hide the Copy affordance as the terminal selection changes.
+    const unsubscribeSelection = adapter.onSelectionChange((has) => setHasSelection(has));
+
     // Reflow on every container size change (window resize, rail drag, grid
     // <-> single, tile show/hide). scheduleFit coalesces bursts to one fit per
     // frame and skips the hidden-0x0 case.
@@ -263,6 +273,7 @@ export function TerminalCard({
       }
       lastSentDimsRef.current = null;
       unsubscribeInput();
+      unsubscribeSelection();
       resizeObserver.disconnect();
       void connection.close();
       adapter.dispose();
@@ -306,6 +317,38 @@ export function TerminalCard({
     onFocusRequest?.();
   }, [onFocusRequest]);
 
+  const handleCopy = useCallback(() => {
+    void adapterRef.current?.copySelection().then((ok) => {
+      if (ok) {
+        setCopied(true);
+        setTimeout(() => setCopied(false), 1200);
+      }
+    });
+  }, []);
+
+  const clearHoverTimer = useCallback(() => {
+    if (hoverTimerRef.current !== null) {
+      clearTimeout(hoverTimerRef.current);
+      hoverTimerRef.current = null;
+    }
+  }, []);
+
+  // Focus-follows-mouse with a dwell delay: arm a timer on enter, fire only if
+  // the pointer is still resting here after HOVER_FOCUS_DELAY_MS.
+  const handleMouseEnter = useCallback(() => {
+    if (!onHoverFocus) {
+      return;
+    }
+    clearHoverTimer();
+    hoverTimerRef.current = setTimeout(() => {
+      hoverTimerRef.current = null;
+      onHoverFocus();
+    }, HOVER_FOCUS_DELAY_MS);
+  }, [onHoverFocus, clearHoverTimer]);
+
+  // Cancel a pending dwell when the pointer leaves or the card unmounts.
+  useEffect(() => clearHoverTimer, [clearHoverTimer]);
+
   const prov = providerMeta(target.instance_type);
   const badge = [prov.label, target.instance_name, region].filter(Boolean).join(" · ");
 
@@ -322,7 +365,8 @@ export function TerminalCard({
       data-focused={isFocused}
       data-connection-state={connectionState}
       style={{ display: isVisible ? undefined : "none" }}
-      onMouseEnter={onHoverFocus}
+      onMouseEnter={handleMouseEnter}
+      onMouseLeave={clearHoverTimer}
     >
       <header className="terminal-card-header">
         {/* The header (left of the controls) is the drag handle for reordering
@@ -350,6 +394,20 @@ export function TerminalCard({
           {STATE_LABELS[connectionState]}
         </span>
         <div className="terminal-card-controls">
+          {hasSelection && (
+            <button
+              type="button"
+              className="tc-btn"
+              data-testid={`terminal-copy-${target.id}`}
+              title="Copy selection (⌘C / Ctrl+Shift+C)"
+              onClick={(e) => {
+                e.stopPropagation();
+                handleCopy();
+              }}
+            >
+              {copied ? "✓ Copied" : "⧉ Copy"}
+            </button>
+          )}
           {needsManualReconnect && (
             <button
               type="button"

{remo_cli-2.2.0rc10 → remo_cli-2.2.0rc12}/frontend/src/terminal/GhosttyRenderer.ts

@@ -10,7 +10,8 @@
 // configured font/size so the cell grid stays correct after a font change.
 
 import { Terminal } from "ghostty-web";
-import { inputForKeyEvent } from "./keymap";
+import { copyText } from "../lib/clipboard";
+import { inputForKeyEvent, isCopyChord } from "./keymap";
 import type {
   RendererAdapter,
   TerminalDimensions,
@@ -63,6 +64,11 @@ export class GhosttyRenderer implements RendererAdapter {
   }
 
   private handleKeyEvent(e: KeyboardEvent): boolean {
+    if (isCopyChord(e) && this.getSelection()) {
+      e.preventDefault();
+      void this.copySelection();
+      return false;
+    }
     const seq = inputForKeyEvent(e);
     if (seq !== null) {
       e.preventDefault();
@@ -134,6 +140,14 @@ export class GhosttyRenderer implements RendererAdapter {
     return selection && selection.length > 0 ? selection : null;
   }
 
+  async copySelection(): Promise<boolean> {
+    const selection = this.getSelection();
+    if (!selection) {
+      return false;
+    }
+    return copyText(selection);
+  }
+
   dispose(): void {
     this.terminal.dispose();
   }

{remo_cli-2.2.0rc10 → remo_cli-2.2.0rc12}/frontend/src/terminal/RendererAdapter.ts

@@ -93,6 +93,12 @@ export interface RendererAdapter {
   /** Returns the currently selected text, or `null` if nothing is selected. */
   getSelection(): string | null;
 
+  /**
+   * Copies the current selection to the system clipboard (best-effort; needs a
+   * secure context). Returns true if there was a selection that was copied.
+   */
+  copySelection(): Promise<boolean>;
+
   /** Tears down the renderer and releases all resources/listeners. */
   dispose(): void;
 }

{remo_cli-2.2.0rc10 → remo_cli-2.2.0rc12}/frontend/src/terminal/XtermRenderer.ts

@@ -20,16 +20,30 @@ import { Terminal } from "@xterm/xterm";
 import { FitAddon } from "@xterm/addon-fit";
 import { LigaturesAddon } from "@xterm/addon-ligatures";
 import { WebglAddon } from "@xterm/addon-webgl";
+import { WebLinksAddon } from "@xterm/addon-web-links";
+import { ClipboardAddon, type IClipboardProvider } from "@xterm/addon-clipboard";
 // xterm ships its own stylesheet; without it the terminal renders with broken
 // cell sizing/positioning. Bundled here so it loads whenever this renderer is.
 import "@xterm/xterm/css/xterm.css";
-import { inputForKeyEvent } from "./keymap";
+import { copyText } from "../lib/clipboard";
+import { inputForKeyEvent, isCopyChord } from "./keymap";
 import type {
   RendererAdapter,
   TerminalDimensions,
   TerminalFontOptions,
 } from "./RendererAdapter";
 
+// OSC 52 handling: WRITE lets a remote app (e.g. Claude Code's copy-on-select)
+// push text to the browser clipboard; READ is denied so a remote app can never
+// exfiltrate the operator's clipboard. Best-effort — an escape-sequence write
+// has no user gesture, so some browsers may reject it.
+const _osc52Provider: IClipboardProvider = {
+  readText: async () => "",
+  writeText: async (_selection, text) => {
+    await copyText(text);
+  },
+};
+
 const DEFAULT_FONT: TerminalFontOptions = {
   fontFamily: "Menlo, Consolas, 'DejaVu Sans Mono', monospace",
   fontSize: 13,
@@ -80,6 +94,13 @@ export class XtermRenderer implements RendererAdapter {
   }
 
   private handleKeyEvent(e: KeyboardEvent): boolean {
+    // Copy the selection on ⌘C / Ctrl+Shift+C — but only when something is
+    // selected, so bare Ctrl+C still reaches the shell as SIGINT.
+    if (isCopyChord(e) && this.terminal.hasSelection()) {
+      e.preventDefault();
+      void this.copySelection();
+      return false;
+    }
     const seq = inputForKeyEvent(e);
     if (seq !== null) {
       // preventDefault stops the browser from also inserting a newline into
@@ -116,6 +137,12 @@ export class XtermRenderer implements RendererAdapter {
     this.enableWebgl();
     // Now that the terminal is attached, load the ligatures addon if wanted.
     this.applyLigatures(this.ligaturesEnabled);
+    // Clickable http(s) links — open in a new tab, severing opener access.
+    this.terminal.loadAddon(
+      new WebLinksAddon((_event, uri) => window.open(uri, "_blank", "noopener,noreferrer")),
+    );
+    // OSC 52 (remote-app clipboard writes, e.g. Claude Code copy-on-select).
+    this.terminal.loadAddon(new ClipboardAddon(_osc52Provider));
   }
 
   // GPU-accelerated rendering. Must run after open(). Best-effort: a failed
@@ -185,6 +212,14 @@ export class XtermRenderer implements RendererAdapter {
     return selection.length > 0 ? selection : null;
   }
 
+  async copySelection(): Promise<boolean> {
+    const selection = this.getSelection();
+    if (!selection) {
+      return false;
+    }
+    return copyText(selection);
+  }
+
   dispose(): void {
     // Dispose the WebGL addon before the terminal so its GPU context/canvas is
     // released cleanly (Terminal.dispose would also drop it, but ordering is

{remo_cli-2.2.0rc10 → remo_cli-2.2.0rc12}/frontend/src/terminal/keymap.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { inputForKeyEvent } from "./keymap";
+import { inputForKeyEvent, isCopyChord } from "./keymap";
 
 function key(init: KeyboardEventInit & { type?: string }): KeyboardEvent {
   const { type = "keydown", ...rest } = init;
@@ -30,3 +30,20 @@ describe("inputForKeyEvent", () => {
     expect(inputForKeyEvent(key({ key: "a", shiftKey: true }))).toBeNull();
   });
 });
+
+describe("isCopyChord", () => {
+  it("recognizes ⌘C and Ctrl+Shift+C", () => {
+    expect(isCopyChord(key({ key: "c", metaKey: true }))).toBe(true);
+    expect(isCopyChord(key({ key: "C", ctrlKey: true, shiftKey: true }))).toBe(true);
+  });
+
+  it("leaves bare Ctrl+C alone (stays SIGINT)", () => {
+    expect(isCopyChord(key({ key: "c", ctrlKey: true }))).toBe(false);
+  });
+
+  it("ignores other keys, plain c, and non-keydown events", () => {
+    expect(isCopyChord(key({ key: "v", metaKey: true }))).toBe(false);
+    expect(isCopyChord(key({ key: "c" }))).toBe(false);
+    expect(isCopyChord(key({ key: "c", metaKey: true, type: "keyup" }))).toBe(false);
+  });
+});

{remo_cli-2.2.0rc10 → remo_cli-2.2.0rc12}/frontend/src/terminal/keymap.ts

@@ -25,3 +25,18 @@ export function inputForKeyEvent(e: KeyboardEvent): string | null {
   }
   return null;
 }
+
+/**
+ * Whether a key event is the "copy the selection" chord: **Cmd+C** (macOS) or
+ * **Ctrl+Shift+C** (Linux/Windows). Bare `Ctrl+C` is deliberately excluded so it
+ * stays SIGINT. The renderer only copies when there is actually a selection —
+ * otherwise the chord is left alone.
+ */
+export function isCopyChord(e: KeyboardEvent): boolean {
+  if (e.type !== "keydown" || (e.key !== "c" && e.key !== "C")) {
+    return false;
+  }
+  const cmdC = e.metaKey && !e.ctrlKey && !e.altKey; // macOS ⌘C
+  const ctrlShiftC = e.ctrlKey && e.shiftKey && !e.metaKey && !e.altKey; // Linux/Win
+  return cmdC || ctrlShiftC;
+}

{remo_cli-2.2.0rc10 → remo_cli-2.2.0rc12}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "remo-cli"
-version = "2.2.0rc10"
+version = "2.2.0rc12"
 description = "Remote development environment CLI"
 readme = "README.md"
 license = "MIT"

{remo_cli-2.2.0rc10 → remo_cli-2.2.0rc12}/uv.lock

@@ -1038,7 +1038,7 @@ wheels = [
 
 [[package]]
 name = "remo-cli"
-version = "2.2.0rc10"
+version = "2.2.0rc12"
 source = { editable = "." }
 dependencies = [
     { name = "ansible-core" },