Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
TypeScript adeagent-ideai-agentsautomationbotclaude-codecodexghosttygrok-bothermes-agentmobile-appmuseopenclawopencodeorchestrationpiruntimeterminalworktreesyc-backed
import { spawnSync } from 'node:child_process'
/** Developer machines may skip without fish; required shell-contract CI is the only end-to-end #9993 guard, so ORCA_REQUIRE_FISH=1 must fail instead. */
const FISH_CANDIDATES = ['fish', '/opt/homebrew/bin/fish', '/usr/local/bin/fish'] as const
/** Env var CI sets to make a missing or too-old fish fail instead of skip. */
export const REQUIRE_FISH_ENV_VAR = 'ORCA_REQUIRE_FISH'
export type FishBinaryLookup =
| { available: true; path: string; majorVersion: number }
| { available: false; path: null; majorVersion: number; reason: string }
export function resolveFishBinary(minMajorVersion = 1): FishBinaryLookup {
if (process.platform === 'win32') {
return {
available: false,
path: null,
majorVersion: 0,
reason: 'fish is not supported on Windows'
}
}
for (const path of FISH_CANDIDATES) {
const probe = spawnSync(path, ['--version'], { encoding: 'utf8' })
if (probe.status !== 0) {
continue
}
const majorVersion = Number(/version (\d+)/.exec(probe.stdout ?? '')?.[1] ?? '0')
if (majorVersion < minMajorVersion) {
return {
available: false,
path: null,
majorVersion,
reason: `fish ${minMajorVersion}+ required, found ${probe.stdout?.trim() || 'an unknown version'} at ${path}`
}
}
return { available: true, path, majorVersion }
}
return { available: false, path: null, majorVersion: 0, reason: 'no fish binary on PATH' }
}
/** Return CI’s missing/old-fish failure or null. Assert outside the guarded suite so skipping it cannot hide the requirement. */
export function fishRequirementViolation(
lookup: FishBinaryLookup,
env: NodeJS.ProcessEnv = process.env
): string | null {
if (lookup.available || env[REQUIRE_FISH_ENV_VAR] !== '1') {
return null
}
return `${REQUIRE_FISH_ENV_VAR}=1 but the live fish tests would skip: ${lookup.reason}`
}