stablyai/orca · error · RuntimeClientError

unsupported_platform

unsupported_platform

Error message

Claude Agent Teams native panes are not supported on Windows.

What it means

The claude-teams handler (core.ts:63) guards process.platform === 'win32' and throws unsupported_platform before any work. Native Orca panes for Claude Agent Teams depend on POSIX process/pty behavior that the Windows build of Orca does not provide, so the subcommand is hard-blocked on Windows rather than partially working.

Source

Thrown at src/cli/handlers/core.ts:63

function getOptionalServePort(flags: Map<string, string | boolean>): string | null {
  if (!flags.has('port')) {
    return null
  }
  const rawPort = flags.get('port')
  if (typeof rawPort !== 'string' || rawPort.length === 0) {
    throw new RuntimeClientError('invalid_argument', 'Missing value for --port.')
  }
  const port = Number(rawPort)
  if (!Number.isInteger(port) || port < 0 || port > 65535) {
    throw new RuntimeClientError('invalid_argument', `Invalid --port value: ${rawPort}`)
  }
  return rawPort
}

export const CORE_HANDLERS: Record<string, CommandHandler> = {
  'claude-teams': async ({ client, rawArgs }) => {
    if (process.platform === 'win32') {
      throw new RuntimeClientError(
        'unsupported_platform',
        'Claude Agent Teams native panes are not supported on Windows.'
      )
    }
    const paneKey = process.env.ORCA_PANE_KEY
    if (!paneKey) {
      throw new RuntimeClientError(
        'invalid_environment',
        'orca claude-teams must be run inside an Orca terminal.'
      )
    }
    const response = await client.call<{ launch: { env: Record<string, string> } }>(
      'agentTeams.prepareLaunch',
      {
        paneKey,
        env: envRecord()
      }
    )

View on GitHub (pinned to 1136503c6a)

Solutions

1. Run claude-teams on macOS or Linux instead
2. On Windows, use WSL and invoke the Linux build of Orca inside it
3. Use a different Claude Agent Teams integration path supported on Windows

function assertNotWindowsForTeams() {
  if (process.platform === 'win32') {
    throw new Error('Claude Agent Teams native panes are not supported on Windows')
  }
}

When it happens

Trigger: Running `orca claude-teams ...` (any args) on a win32 build of Orca. The platform is read from process.platform, so the check is exact: only 'win32' is blocked.

Common situations: CI on a Windows runner; a Windows user installing the native Orca build; WSL users accidentally running the Windows orca.exe instead of the Linux binary inside WSL.

Related errors

• Unsupported --expect=${value}. Use none, repro, or pass.
• Unsupported --gpu=${value}. Use on, off, auto, or a comma-li
• Unknown argument: ${arg}
• This repro harness is intentionally Windows-only.
• invalid_environment

AI-assisted analysis of stablyai/orca@1136503c6a (2026-08-12). Data as JSON: /api/errors/e8591e7ec15aef75. Report an issue: GitHub.