stablyai/orca · error · RuntimeClientError

accessibility_error

accessibility_error

Error message

Orca Computer Use.app was not found

What it means

openComputerUsePermissionsAsync resolves the helper app path via resolveMacOSComputerUseAppPath() and throws accessibility_error if it returns null. The helper app brokers macOS TCC permission prompts and status checks, so computer-use permissions cannot be managed without it. macOS-only.

Source

Thrown at src/main/computer/macos-computer-use-permissions.ts:43

): Promise<ComputerUsePermissionSetupResult> {
  if (process.platform !== 'darwin') {
    return {
      platform: process.platform,
      helperAppPath: null,
      permissionId,
      openedSettings: false,
      launchedHelper: false,
      permissions: [
        { id: 'accessibility', status: 'unsupported' },
        { id: 'screenshots', status: 'unsupported' }
      ],
      nextStep: null
    }
  }

  const helperAppPath = resolveMacOSComputerUseAppPath()
  if (!helperAppPath) {
    throw new RuntimeClientError('accessibility_error', 'Orca Computer Use.app was not found')
  }
  const status = await getComputerUsePermissionStatus()
  if (status.helperUnavailableReason) {
    throw new RuntimeClientError('accessibility_error', status.helperUnavailableReason)
  }
  const nextStep = nextPermissionStep(status.permissions)

  if (!permissionId && !nextStep) {
    return {
      platform: process.platform,
      helperAppPath,
      permissionId,
      openedSettings: false,
      launchedHelper: false,
      permissions: status.permissions,
      nextStep
    }
  }

View on GitHub (pinned to 1136503c6a)

Solutions

1. Reinstall the app to restore Orca Computer Use.app.
2. Verify the bundle exists at the expected resources path.
3. Rebuild the app packaging to include the helper bundle.

import { resolveMacOSComputerUseAppPath } from './macos-native-provider-paths'
if (process.platform === 'darwin' && !resolveMacOSComputerUseAppPath()) {
  // surface 'helper app missing, reinstall' to the user
}

When it happens

Trigger: macOS; the helper app bundle was not shipped or installed; the bundle was moved or deleted; resolveMacOSComputerUseAppPath returns null.

Common situations: Incomplete install; a dev build without the bundled helper; a custom install location the resolver cannot find.

Related errors

• accessibility_error
• Unsupported local-build compatibility architecture: ${contex
• Missing Orca Computer Use helper app at ${helperAppPath}
• Missing signing identity for Orca Computer Use helper app
• Missing orca-notification-status helper at ${helperPath}

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