Skip to content

A self-improving RLM agent for coding workflows and long-running autonomous tasks.

Rust

fix(coding-agent): restore Ghostty fullscreen mouse capture (#1385)

Seth Kartenfd789e21e105
diff --git a/packages/coding-agent/CHANGELOG.md b/packages/coding-agent/CHANGELOG.md
index 08322c0f15..60589450e1 100644
--- a/packages/coding-agent/CHANGELOG.md
+++ b/packages/coding-agent/CHANGELOG.md
@@ -2,6 +2,7 @@
## [Unreleased]
+- Fixed fullscreen wheel scrolling in Ghostty while retaining application link clicks; set `terminal.fullscreenMouse` to `false` to use native Cmd-click instead.
- Changed the agents view to sort idle and inactive sessions by last message time, newest first, while keeping running agents in stable creation order.
- Fixed `openai-codex` models being invisible to `rlm` subagents and `find_models` because model discovery reported Prime Agent's own version as the Codex client version ([#1375](https://github.com/PrimeIntellect-ai/prime-agent/pull/1375) by [@bilelrais](https://github.com/bilelrais)).
- Added a working hint that recommends sharing traces with Prime Intellect to help train open-source LLMs.
diff --git a/packages/coding-agent/src/core/settings-manager.ts b/packages/coding-agent/src/core/settings-manager.ts
index 9e64ca4cf3..d221ccc7e5 100644
--- a/packages/coding-agent/src/core/settings-manager.ts
+++ b/packages/coding-agent/src/core/settings-manager.ts
@@ -45,7 +45,7 @@ export interface TerminalSettings {
clearOnShrink?: boolean; // default: false (clear empty rows when content shrinks)
showTerminalProgress?: boolean; // default: false (OSC 9;4 terminal progress indicators)
fullscreen?: boolean; // default: true (alternate-screen rendering with scrollable transcript)
- fullscreenMouse?: boolean; // default: true, except false in Ghostty to preserve native Cmd-click links
+ fullscreenMouse?: boolean; // default: true
}
export interface ImageSettings {
@@ -1154,19 +1154,7 @@ export class SettingsManager {
}
getFullscreenMouse(): boolean {
- const configured = this.settings.terminal?.fullscreenMouse;
- if (typeof configured === "boolean") return configured;
- // Ghostty's native Cmd-click URL handling is suppressed while an
- // application enables mouse reporting, and SGR cannot encode Command for
- // the application to reproduce that gesture. Preserve native link clicks
- // by default; users can explicitly enable fullscreen mouse capture.
- const termProgram = process.env.TERM_PROGRAM?.toLowerCase();
- const term = process.env.TERM?.toLowerCase();
- const isGhostty =
- termProgram === "ghostty" ||
- term?.includes("ghostty") === true ||
- (termProgram === undefined && !!process.env.GHOSTTY_RESOURCES_DIR);
- return !isGhostty;
+ return this.settings.terminal?.fullscreenMouse ?? true;
}
setFullscreenMouse(enabled: boolean): void {
diff --git a/packages/coding-agent/test/fullscreen-mode.test.ts b/packages/coding-agent/test/fullscreen-mode.test.ts
index d360218843..1389dafcf8 100644
--- a/packages/coding-agent/test/fullscreen-mode.test.ts
+++ b/packages/coding-agent/test/fullscreen-mode.test.ts
@@ -2,7 +2,6 @@ import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
import { join } from "path";
import { afterEach, beforeEach, describe, expect, it } from "vitest";
import { SettingsManager } from "../src/core/settings-manager.js";
-import { BUILTIN_SLASH_COMMANDS } from "../src/core/slash-commands.js";
describe("fullscreen mode settings", () => {
const testDir = join(process.cwd(), "test-fullscreen-tmp");
@@ -10,8 +9,6 @@ describe("fullscreen mode settings", () => {
const projectDir = join(testDir, "project");
let savedEnv: string | undefined;
let savedTermProgram: string | undefined;
- let savedTerm: string | undefined;
- let savedGhosttyResourcesDir: string | undefined;
beforeEach(() => {
if (existsSync(testDir)) {
@@ -21,12 +18,8 @@ describe("fullscreen mode settings", () => {
mkdirSync(join(projectDir, ".prime", "agent"), { recursive: true });
savedEnv = process.env.PI_FULLSCREEN;
savedTermProgram = process.env.TERM_PROGRAM;
- savedTerm = process.env.TERM;
- savedGhosttyResourcesDir = process.env.GHOSTTY_RESOURCES_DIR;
delete process.env.PI_FULLSCREEN;
delete process.env.TERM_PROGRAM;
- delete process.env.TERM;
- delete process.env.GHOSTTY_RESOURCES_DIR;
});
afterEach(() => {
@@ -40,48 +33,12 @@ describe("fullscreen mode settings", () => {
}
if (savedTermProgram === undefined) delete process.env.TERM_PROGRAM;
else process.env.TERM_PROGRAM = savedTermProgram;
- if (savedTerm === undefined) delete process.env.TERM;
- else process.env.TERM = savedTerm;
- if (savedGhosttyResourcesDir === undefined) delete process.env.GHOSTTY_RESOURCES_DIR;
- else process.env.GHOSTTY_RESOURCES_DIR = savedGhosttyResourcesDir;
});
- it("defaults to on with mouse enabled", () => {
- const manager = SettingsManager.create(projectDir, agentDir);
- expect(manager.getFullscreen()).toBe(true);
- expect(manager.getFullscreenMouse()).toBe(true);
- });
-
- it("preserves native Ghostty link clicks by disabling mouse capture by default", () => {
+ it("defaults to fullscreen with mouse capture in Ghostty", () => {
process.env.TERM_PROGRAM = "ghostty";
const manager = SettingsManager.create(projectDir, agentDir);
- expect(manager.getFullscreenMouse()).toBe(false);
- });
-
- it("detects Ghostty through TERM in SSH sessions", () => {
- process.env.TERM = "xterm-ghostty";
- const manager = SettingsManager.create(projectDir, agentDir);
- expect(manager.getFullscreenMouse()).toBe(false);
- });
-
- it("honors explicit mouse capture when TERM identifies Ghostty", () => {
- process.env.TERM = "xterm-ghostty";
- const manager = SettingsManager.create(projectDir, agentDir);
- manager.setFullscreenMouse(true);
- expect(manager.getFullscreenMouse()).toBe(true);
- });
-
- it("does not mistake an integrated terminal inheriting Ghostty variables for Ghostty", () => {
- process.env.TERM_PROGRAM = "vscode";
- process.env.GHOSTTY_RESOURCES_DIR = "/Applications/Ghostty.app/Contents/Resources/ghostty";
- const manager = SettingsManager.create(projectDir, agentDir);
- expect(manager.getFullscreenMouse()).toBe(true);
- });
-
- it("honors an explicit fullscreen mouse setting in Ghostty", () => {
- process.env.GHOSTTY_RESOURCES_DIR = "/Applications/Ghostty.app/Contents/Resources/ghostty";
- const manager = SettingsManager.create(projectDir, agentDir);
- manager.setFullscreenMouse(true);
+ expect(manager.getFullscreen()).toBe(true);
expect(manager.getFullscreenMouse()).toBe(true);
});
@@ -117,7 +74,8 @@ describe("fullscreen mode settings", () => {
expect(manager.getFullscreen()).toBe(false);
});
- it("persists the fullscreen mouse toggle", async () => {
+ it("persists an explicit fullscreen mouse opt-out in Ghostty", async () => {
+ process.env.TERM_PROGRAM = "ghostty";
const manager = SettingsManager.create(projectDir, agentDir);
manager.setFullscreenMouse(false);
await manager.flush();
@@ -126,12 +84,3 @@ describe("fullscreen mode settings", () => {
expect(reloaded.getFullscreenMouse()).toBe(false);
});
});
-
-describe("fullscreen slash command", () => {
- it("is registered with an on|off argument hint", () => {
- const command = BUILTIN_SLASH_COMMANDS.find((c) => c.name === "fullscreen");
- expect(command).toBeDefined();
- expect(command?.argumentHint).toBe("[on|off]");
- expect(command?.takesArgument).toBe(true);
- });
-});