{"record":{"id":"e8591e7ec15aef75","repo":"stablyai/orca","slug":"unsupported-platform","errorCode":"unsupported_platform","errorMessage":"Claude Agent Teams native panes are not supported on Windows.","messagePattern":"Claude Agent Teams native panes are not supported on Windows\\.","errorType":"exception","errorClass":"RuntimeClientError","httpStatus":null,"severity":"error","filePath":"src/cli/handlers/core.ts","lineNumber":63,"sourceCode":"function getOptionalServePort(flags: Map<string, string | boolean>): string | null {\n  if (!flags.has('port')) {\n    return null\n  }\n  const rawPort = flags.get('port')\n  if (typeof rawPort !== 'string' || rawPort.length === 0) {\n    throw new RuntimeClientError('invalid_argument', 'Missing value for --port.')\n  }\n  const port = Number(rawPort)\n  if (!Number.isInteger(port) || port < 0 || port > 65535) {\n    throw new RuntimeClientError('invalid_argument', `Invalid --port value: ${rawPort}`)\n  }\n  return rawPort\n}\n\nexport const CORE_HANDLERS: Record<string, CommandHandler> = {\n  'claude-teams': async ({ client, rawArgs }) => {\n    if (process.platform === 'win32') {\n      throw new RuntimeClientError(\n        'unsupported_platform',\n        'Claude Agent Teams native panes are not supported on Windows.'\n      )\n    }\n    const paneKey = process.env.ORCA_PANE_KEY\n    if (!paneKey) {\n      throw new RuntimeClientError(\n        'invalid_environment',\n        'orca claude-teams must be run inside an Orca terminal.'\n      )\n    }\n    const response = await client.call<{ launch: { env: Record<string, string> } }>(\n      'agentTeams.prepareLaunch',\n      {\n        paneKey,\n        env: envRecord()\n      }\n    )","sourceCodeStart":45,"sourceCodeEnd":81,"githubUrl":"https://github.com/stablyai/orca/blob/1136503c6a231a16dce8f921f6fadb63d181e8db/src/cli/handlers/core.ts#L45-L81","documentation":"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.","triggerScenarios":"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.","commonSituations":"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.","solutions":["Run claude-teams on macOS or Linux instead","On Windows, use WSL and invoke the Linux build of Orca inside it","Use a different Claude Agent Teams integration path supported on Windows"],"exampleFix":null,"handlingStrategy":"validation","validationCode":"function assertNotWindowsForTeams() {\n  if (process.platform === 'win32') {\n    throw new Error('Claude Agent Teams native panes are not supported on Windows')\n  }\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Run claude-teams on macOS or Linux; on Windows use WSL with the Linux Orca build","Gate the code path on process.platform in your orchestrator so Windows runners skip it"],"tags":["cli","claude-teams","platform","windows","unsupported"],"backgroundTag":null,"analyzedSha":"1136503c6a231a16dce8f921f6fadb63d181e8db","analyzedAt":"2026-08-12T23:15:58.167Z","schemaVersion":2},"datasetVersion":"2026-08-12T23:17:12.415Z"}