orcs-oss/orcs-code
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: expose flicker-free mode as a /config toggle (closes #260) (#265)

Browse Source 
Add flickerFreeMode to GlobalConfig so external users can enable
fullscreen alt-screen mode via /config instead of having to set
the CLAUDE_CODE_NO_FLICKER=1 env var manually.

Priority order in isFullscreenEnvEnabled():
  CLAUDE_CODE_NO_FLICKER=0  → always off (env wins)
  CLAUDE_CODE_NO_FLICKER=1  → always on (env wins)
  tmux -CC detected         → off (terminal safety guard)
  config flickerFreeMode    → user preference (new)
  USER_TYPE=ant             → internal default

The env var still takes full precedence so existing scripts and
automation are unaffected. The new setting only activates when
flickerFreeMode is explicitly set in config.
This commit is contained in:
KRATOS
2026-04-03 18:47:38 +05:30
committed by GitHub
parent 7c0ea68b65
commit 19c00e67ed
3 changed files with 43 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
src/utils/fullscreen.ts
View File

@@ -1,5 +1,6 @@
import { spawnSync } from 'child_process'
import { getIsInteractive } from '../bootstrap/state.js'
import { getGlobalConfig } from './config.js'
import { logForDebugging } from './debug.js'
import { isEnvDefinedFalsy, isEnvTruthy } from './envUtils.js'
import { execFileNoThrow } from './execFileNoThrow.js'
@@ -105,14 +106,21 @@ export function _resetTmuxControlModeProbeForTesting(): void {
}
/**
* Runtime env-var check only. Ants default to on (CLAUDE_CODE_NO_FLICKER=0
* to opt out); external users default to off (CLAUDE_CODE_NO_FLICKER=1 to
* opt in).
* Whether fullscreen (flicker-free) mode is enabled. Env var takes highest
* precedence, then the `flickerFreeMode` config setting, then the ant-only
* default. External users can enable via `/config` instead of setting the env.
*
* Priority order:
* CLAUDE_CODE_NO_FLICKER=0 → always off
* CLAUDE_CODE_NO_FLICKER=1 → always on (overrides tmux -CC guard too)
* tmux -CC detected → off (corrupts terminal state)
* config flickerFreeMode → on/off per user preference
* USER_TYPE=ant → on by default for internal users
*/
export function isFullscreenEnvEnabled(): boolean {
// Explicit user opt-out always wins.
// Explicit env opt-out always wins.
if (isEnvDefinedFalsy(process.env.CLAUDE_CODE_NO_FLICKER)) return false
// Explicit opt-in overrides auto-detection (escape hatch).
// Explicit env opt-in overrides everything including tmux -CC.
if (isEnvTruthy(process.env.CLAUDE_CODE_NO_FLICKER)) return true
// Auto-disable under tmux -CC: alt-screen + mouse tracking corrupts
// terminal state on double-click and mouse wheel is dead.
@@ -125,6 +133,10 @@ export function isFullscreenEnvEnabled(): boolean {
}
return false
}
// Config-based toggle: lets external users enable flicker-free mode via
// `/config` without having to set an env var.
const configValue = getGlobalConfig().flickerFreeMode
if (configValue !== undefined) return configValue
return process.env.USER_TYPE === 'ant'
}