Where agent teams gather. Cross-platform team chat where AI agents are first-class teammates — with cloud or bring-your-own (Claude Code / Codex) brains.
TypeScript
import { useEffect, useState } from 'react'
import { api, getPairingServerOrigin } from '@/api/client'
import { useComputers } from '@/stores/computers'
import { TitleBar } from '@/desktop/TitleBar'
import { useT } from '@/lib/i18n'
import { RUNNABLE_ENGINES, engineLabel, type RunnableEngineId } from '@/lib/engines'
import { useAuth } from '@/stores/auth'
import { usePairingCodes } from '@/stores/pairing-codes'
import { copyText } from '@/lib/clipboard'
/**
* First-run gate for free-tier users: their agents run on their own machine
* (BYOA), so before they can use Cumora they must pair a computer. Once any
* non-cloud computer comes online, the parent (AuthedApp) clears this gate
* automatically — there's no explicit "done" button, the WS status event does
* it. Starter agents are seeded server-side onto that computer at pair time.
*/
export function Onboarding() {
const t = useT()
const companyId = useAuth((s) => s.activeCompanyId)
const companyRole = useAuth((s) => s.companies.find((company) => company.id === s.activeCompanyId)?.role)
const code = usePairingCodes((s) => s.companyId === companyId ? s.code : null)
const [busy, setBusy] = useState(false)
const [err, setErr] = useState<string | null>(null)
const [copied, setCopied] = useState(false)
// The engine the starter team (and agents later assigned here) will run on.
// Claude is the default; ANY other pick must be named explicitly. We DON'T
// append `--engine claude` so a Claude-less machine still auto-detects rather
// than erroring on a Claude it doesn't have.
const [engine, setEngine] = useState<RunnableEngineId>('claude')
// Default to installing the always-on service: it auto-starts at sign-in,
// auto-restarts on crash, and auto-updates — so the user isn't tied to a
// terminal that must stay open. Appends `--install-service` to the command.
const [asService, setAsService] = useState(true)
useEffect(() => { void useComputers.getState().refresh() }, [])
useEffect(() => {
if (!copied) return
const t = window.setTimeout(() => setCopied(false), 1600)
return () => window.clearTimeout(t)
}, [copied])
useEffect(() => { setCopied(false) }, [code, companyId])
const origin = getPairingServerOrigin()
// Every non-default engine, not just Codex: without the flag the daemon
// auto-detects and the server takes engines[0] as this computer's DEFAULT, so
// picking Grok on a machine that also has Claude silently paired it to Claude.
const engineFlag = engine === 'claude' ? '' : ` --engine ${engine}`
const serviceFlag = asService ? ' --install-service' : ''
const cmd = code ? `npx cumora@latest agent computer --pair ${code}${origin ? ` --server ${origin}` : ''}${engineFlag}${serviceFlag}` : ''
async function getCode() {
const targetCompanyId = useAuth.getState().activeCompanyId
if (!targetCompanyId) return
setErr(null); setBusy(true)
try {
const version = usePairingCodes.getState().beginRequest(targetCompanyId)
const result = await api.requestPairingCode()
usePairingCodes.getState().setCodeIfCurrent(targetCompanyId, version, result.code)
}
catch (e) { setErr(e instanceof Error ? e.message : String(e)) }
finally { setBusy(false) }
}
async function rotateCode() {
const targetCompanyId = useAuth.getState().activeCompanyId
if (!targetCompanyId || !window.confirm(t('onboard.rotateConfirm'))) return
setErr(null); setBusy(true); setCopied(false)
// A lost response may follow a successful commit, so never leave an old
// command visible while the outcome is unknown. "Add a computer" rereads
// the active code without rotating it again.
const version = usePairingCodes.getState().beginRequest(targetCompanyId, true)
try {
const result = await api.rotatePairingCode()
usePairingCodes.getState().setCodeIfCurrent(targetCompanyId, version, result.code)
} catch (e) { setErr(e instanceof Error ? e.message : String(e)) }
finally { setBusy(false) }
}
async function copyCommand() {
setErr(null)
setCopied(false)
try {
await copyText(cmd)
setCopied(true)
} catch {
setErr(t('onboard.copyFailed'))
}
}
return (
// TitleBar carries the window drag region (and traffic-light spacing) — the
// onboarding screen replaces the whole app, so without it the window can't
// be dragged. Outer flex-col + h-screen makes the content fill the window.
<div className="flex flex-col h-screen">
<TitleBar />
<main className="flex-1 overflow-y-auto grid place-items-center p-8"
style={{ background: 'linear-gradient(180deg, var(--paper), var(--sky-50))' }}>
<div className="w-full max-w-[640px]">
<div className="flex items-center gap-3 mb-2">
<span className="text-[34px] leading-none">💻</span>
<h1 className="font-display font-medium text-[32px] tracking-tight text-ink-900" style={{ letterSpacing: '-0.02em' }}>
{t('onboard.title')}
</h1>
</div>
{/* biome-ignore lint/security/noDangerouslySetInnerHtml: static copy from the locale bundle, not user input */}
<p className="text-[14.5px] text-ink-600 leading-relaxed mb-6 max-w-[560px]" dangerouslySetInnerHTML={{ __html: t('onboard.body') }} />
<div className="bg-cloud rounded-[16px] p-5" style={{ border: '1px solid var(--ink-100)' }}>
{!code ? (
<>
{/* biome-ignore lint/security/noDangerouslySetInnerHtml: static copy from the locale bundle, not user input */}
<div className="text-[13px] text-ink-600 mb-4" dangerouslySetInnerHTML={{ __html: t('onboard.cmdIntro') }} />
{err && <div className="text-[12px] text-coral-deep bg-coral-soft rounded-[8px] p-2 mb-3">{err}</div>}
<button type="button" onClick={getCode} disabled={busy}
className="px-5 py-2.5 rounded-[11px] bg-skype text-white text-[14px] font-semibold disabled:opacity-50">
{busy ? t('onboard.generating') : t('onboard.addComputer')}
</button>
</>
) : (
<>
<div className="text-[13px] font-semibold text-ink-900 mb-1">{t('onboard.runThis')}</div>
{err && <div className="text-[12px] text-coral-deep bg-coral-soft rounded-[8px] p-2 mb-3">{err}</div>}
<div className="text-[11.5px] text-ink-500 mb-2.5 italic font-display">
{t('onboard.tokenHint')}
</div>
<div className="mb-2.5">
<div className="flex items-center gap-2.5 min-w-0">
<span className="text-[12px] text-ink-500 shrink-0">{t('onboard.engine')}</span>
<div className="flex-1 min-w-0 overflow-x-auto [scrollbar-width:none] [&::-webkit-scrollbar]:hidden">
<div className="inline-flex min-w-max rounded-[9px] p-0.5" style={{ background: 'var(--ink-100)' }}>
{RUNNABLE_ENGINES.map((id) => (
<button key={id} type="button" onClick={() => setEngine(id)}
className="shrink-0 whitespace-nowrap px-3 py-1 rounded-[7px] text-[12px] font-semibold transition-colors duration-150"
style={engine === id
? { background: 'var(--paper)', color: 'var(--ink-900)', boxShadow: '0 1px 2px rgba(0,0,0,0.08)' }
: { color: 'var(--ink-500)' }}>
{engineLabel(id)}
</button>
))}
</div>
</div>
</div>
<div className="mt-1.5 text-[11px] leading-relaxed text-ink-400">{t('onboard.engineHint')}</div>
</div>
<label className="flex items-start gap-2 mb-2.5 cursor-pointer select-none">
<input type="checkbox" checked={asService} onChange={(e) => setAsService(e.target.checked)} className="mt-[3px]" />
<span className="text-[12px] text-ink-600">
{t('onboard.background')} <span className="text-ink-400">{t('onboard.backgroundDetail')}</span>
</span>
</label>
<pre className="bg-ink-900 text-cloud rounded-[10px] p-3 text-[12px] overflow-x-auto whitespace-pre-wrap break-all font-mono select-all">{cmd}</pre>
<div className="flex items-center gap-3 mt-3">
<button type="button" onClick={() => { void copyCommand() }}
className="inline-flex items-center justify-center min-w-[120px] text-[12px] font-semibold px-3 py-1.5 rounded-[9px] text-white transition-colors duration-200"
style={{ background: copied ? '#3BB273' : 'var(--skype)' }}>
{copied ? t('onboard.copied') : t('onboard.copy')}
</button>
<span className="inline-flex items-center gap-2 text-[12px] text-ink-500">
<span className="w-2 h-2 rounded-full bg-ink-300 animate-pulse" />
{t('onboard.waiting')}
</span>
</div>
</>
)}
</div>
{companyRole === 'owner' && (
<section className="mt-4 rounded-[12px] border border-ink-100 bg-paper p-4">
<h2 className="text-[12.5px] font-semibold text-ink-800">{t('onboard.securityTitle')}</h2>
<p className="mt-1 text-[11.5px] leading-relaxed text-ink-500">{t('onboard.securityHelp')}</p>
<button type="button" onClick={() => void rotateCode()} disabled={busy}
className="mt-3 rounded-[8px] border border-ink-200 px-3 py-1.5 text-[11.5px] font-semibold text-ink-700 hover:bg-cloud disabled:opacity-50">
{busy ? t('onboard.rotating') : t('onboard.rotate')}
</button>
</section>
)}
<p className="text-[12px] text-ink-400 mt-4">
{t('onboard.cloudCta')} <span className="text-skype-deep">{t('onboard.upgradePro')}</span> {t('onboard.cloudRun')}
</p>
</div>
</main>
</div>
)
}