Function DesktopHandoff

src/components/DesktopHandoff.tsx:29–131

({ onDone }: Props)

};

export function DesktopHandoff({ onDone }: Props): React.ReactNode {
  const [state, setState] = useState<DesktopHandoffState>('checking');
  const [error, setError] = useState<string | null>(null);
  const [downloadMessage, setDownloadMessage] = useState<string>('');

  // Handle keyboard input for error and prompt-download states
  useInput(input => {
    if (state === 'error') {
      onDone(error ?? 'Unknown error', { display: 'system' });
      return;
    }
    if (state === 'prompt-download') {
      if (input === 'y' || input === 'Y') {
        openBrowser(getDownloadUrl()).catch(() => {});
        onDone(
          `Starting download. Re-run /desktop once you\u2019ve installed the app.\nLearn more at ${DESKTOP_DOCS_URL}`,
          { display: 'system' },
        );
      } else if (input === 'n' || input === 'N') {
        onDone(`The desktop app is required for /desktop. Learn more at ${DESKTOP_DOCS_URL}`, { display: 'system' });
      }
    }
  });

  useEffect(() => {
    async function performHandoff(): Promise<void> {
      // Check Desktop install status
      setState('checking');
      const installStatus = await getDesktopInstallStatus();

      if (installStatus.status === 'not-installed') {
        setDownloadMessage('Claude Desktop is not installed.');
        setState('prompt-download');
        return;
      }

      if (installStatus.status === 'version-too-old') {
        setDownloadMessage(`Claude Desktop needs to be updated (found v${installStatus.version}, need v1.1.2396+).`);
        setState('prompt-download');
        return;
      }

      // Flush session storage to ensure transcript is fully written
      setState('flushing');
      await flushSessionStorage();

      // Open the deep link (uses claude-dev:// in dev mode)
      setState('opening');
      const result = await openCurrentSessionInDesktop();

      if (!result.success) {
        setError(result.error ?? 'Failed to open Claude Desktop');
        setState('error');
        return;
      }

      // Success - exit the CLI
      setState('success');