Skip to content

[Bug]: Grok mouse wheel / scrollback dead in Orca (TERM_PROGRAM=Orca → Unknown brand) #10613

Open

Description

@LesleyMurfin

Summary

Grok Build mouse-wheel scroll / text selection scrollback is broken in Orca agent panes because Grok does not recognize TERM_PROGRAM=Orca and falls back to terminal: Unknown.

Claude Code is unaffected in the same pane.

Environment

  • Orca 1.4.155 (Linux serve + Mac desktop)
  • Grok 0.2.112
  • TERM_PROGRAM=Orca (hard-coded by Orca PTY spawn)
  • Renderer: xterm.js

Evidence

  1. /doctor → terminal: Unknown
  2. /scroll-debug while scrolling → empty stream / ev (no wheel applied)
  3. Mouse capture appears active (cannot highlight text) but scrollback does not move
  4. Setting TERM_PROGRAM=vscode for the Grok process only restores scroll and reports terminal as VS Code

Related

Request

Please merge/ship #10469 so stock Orca does not require a host PATH shim for Grok scroll + OSC 8.

Activity

  1. nwparker commented on Jul 27, 2026

    @nwparker
    Contributor

    Reproduction confirmed (has_repro)

    Method: Code inspection of all PTY spawn paths on current tree (Linux-capable; host openclaw has packaged Orca + relays). No grok binary on the probe host for live /doctor, but the brand advertisement path is unconditional.

    Root cause

    Orca hard-codes TERM_PROGRAM: 'Orca' on every spawn path:

    Path File
    Local src/main/providers/local-pty-provider.ts (~647)
    Daemon src/main/daemon/pty-subprocess.ts (~566)
    Relay/SSH src/relay/pty-handler.ts (~440)

    There is no grok-only brand override in tree (TERM_PROGRAM=vscode, ORCA_TERM_PROGRAM, or agent-terminal-brand*). Grok does not list Orca in its terminal capability table → terminal: Unknown → mouse-wheel / scrollback profile disabled. Claude is unaffected because it does not brand-gate the same way.

    FORCE_HYPERLINK=1 only forces OSC 8 via supports-hyperlinks; it does not change Grok brand resolution for mouse/scroll.

    Re-run

    rg -n "TERM_PROGRAM: 'Orca'" \
      src/main/providers/local-pty-provider.ts \
      src/main/daemon/pty-subprocess.ts \
      src/relay/pty-handler.ts
    
    rg -n "agent-terminal-brand|TERM_PROGRAM.*=.*vscode|ORCA_TERM_PROGRAM" src || echo "no brand override"

    Live (with grok in an Orca pane)

    echo $TERM_PROGRAM          # → Orca
    # grok /doctor              # → terminal: Unknown; wheel stream empty
    TERM_PROGRAM=vscode grok    # → terminal: VS Code; scroll restored
    

    Fix direction

    Ship stopgap from #10469 (advertise an xterm.js brand for grok only; keep true identity as ORCA_TERM_PROGRAM), plus durable upstream Orca brand in Grok.

    Harness: docs/bug-reproductions/10613-grok-term-program-unknown/README.md

  2. added
    has_reproConclusive reproduction exists (test/script/CLI evidence). See docs/bug-reproductions/
    on Jul 27, 2026
  3. AmethystLiang commented on Aug 3, 2026

    @AmethystLiang
    Contributor

    Looking into it

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

bugSomething isn't workinghas_reproConclusive reproduction exists (test/script/CLI evidence). See docs/bug-reproductions/os:linuxIssues affecting Linuxterminal

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions