Skip to content

Open source Grok Bot alternative, Bring your own agent and subscription: message Claude Code, Codex, Gemini CLI, Cursor, Copilot and 40+ AI agents as bots on your own computer, from iPhone, Mac, Windows, Linux or terminal. Agent-agnostic and free. Also a Muse and Dots alternative. Built in Rust.

feat(desktop): show setup hints on the computer access step that needs them

leepokai9db7ca5df3fe
diff --git a/apps/desktop/src/renderer/views/computer-access/ComputerAccessView.tsx b/apps/desktop/src/renderer/views/computer-access/ComputerAccessView.tsx
index 9c8f0bfb..a89c9ea8 100644
--- a/apps/desktop/src/renderer/views/computer-access/ComputerAccessView.tsx
+++ b/apps/desktop/src/renderer/views/computer-access/ComputerAccessView.tsx
@@ -1,5 +1,5 @@
import type { ReactNode } from 'react'
-import { Button, Spinner } from '../../components/Controls'
+import { Button, IconButton, Spinner } from '../../components/Controls'
import { Icon } from '../../components/Icon'
import { useComputerAccess } from './use-computer-access'
import appIcon from '../../../../resources/icon.png'
@@ -40,7 +40,10 @@ export function ComputerAccessView({ onContinue }: { onContinue?: (ready: boolea
Install the full Codync desktop app to finish setup.
</AccessNotice> : null}
{access.error ? <AccessNotice title="Couldn’t finish setup" icon="exclamationmark.circle" error>{access.error}</AccessNotice> : null}
- <div className="computer-access-section-label"><span>{windows ? 'Availability' : 'Permissions'}</span><span>{ready ? 'All set' : `${completed} of ${mac ? 3 : windows ? 1 : 2} ready`}</span></div>
+ <div className="computer-access-section-label">
+ <span>{windows ? 'Availability' : 'Permissions'}</span>
+ <span>{ready ? 'All set' : `${completed} of ${mac ? 3 : windows ? 1 : 2} ready`}<IconButton title="Check again" icon="arrow.clockwise" size={22} onClick={() => void access.refresh()} /></span>
+ </div>
<div className="computer-access-steps">
{windows ? <AccessRow title="Computer control" icon="cursorarrow.motionlines" detail="Bots can use apps on this computer. Remote screen viewing from your phone isn’t available on Windows yet." done={ready} /> : <>
<AccessRow title="Codync Screen" icon="desktopcomputer" detail="Runs in the background to share your screen and connect your controls." done={helperReady} active={['enable', 'helper', 'background'].includes(step)} status={step === 'background' ? 'Needs approval' : undefined}>
@@ -49,10 +52,12 @@ export function ComputerAccessView({ onContinue }: { onContinue?: (ready: boolea
</AccessRow>
{mac ? <>
<AccessRow title="Screen recording" icon="record.circle" detail="Lets Codync see your screen, including anything visible in your apps." done={screen?.capture === true} active={step === 'capture'}>
+ {step === 'capture' ? <SettingsHint app={access.helperName} /> : null}
{canRequest ? request('capture', 'Allow screen recording') : null}
{access.requested.has('capture') ? <SettingsLink action={() => access.openSettings('capture')} /> : null}
</AccessRow>
<AccessRow title="Control apps" icon="cursorarrow.motionlines" detail="Lets Codync click, type and interact with apps on your behalf." done={screen?.input === true} active={step === 'input'}>
+ {step === 'input' ? <SettingsHint app={access.helperName} control /> : null}
{canRequest ? request('input', 'Allow computer control') : null}
{access.requested.has('input') ? <SettingsLink action={() => access.openSettings('input')} /> : null}
</AccessRow>
@@ -61,16 +66,13 @@ export function ComputerAccessView({ onContinue }: { onContinue?: (ready: boolea
</AccessRow>}
</>}
</div>
- {mac && !ready ? <div className="computer-access-help">
- <Icon name="info.circle" size={13} />
- <p>In System Settings, look for <strong>{access.helperName}</strong>. Computer control may be called <strong>Device Control and Data Access</strong> or <strong>Accessibility</strong>. Return here after granting access; if asked, allow the helper to restart.</p>
- </div> : null}
- <div className="computer-access-reassurance"><Icon name="lock.shield" size={13} /><p>Permissions stay on this computer. {onContinue ? 'You can change them later in Settings → Computer access.' : 'Your other computers keep their own permissions.'}</p></div>
- <footer className="computer-access-footer">
- <Button kind="secondary" onClick={() => void access.refresh()}><Icon name="arrow.clockwise" size={12} /> Check again</Button>
- {onContinue ? <Button kind={ready ? 'primary' : 'secondary'} onClick={() => onContinue(ready)}>{ready ? 'Continue' : 'Set up later'}{ready ? <Icon name="arrow.right" size={12} /> : null}</Button> : null}
- </footer>
- <p className="computer-access-phone-note">On iPhone, connect with a QR code or Ask Access. No SSH setup needed.</p>
+ <ul className="computer-access-notes">
+ <li><Icon name="lock.shield" size={13} /><p>Permissions stay on this computer. {onContinue ? 'You can change them later in Settings → Computer access.' : 'Your other computers keep their own permissions.'}</p></li>
+ <li><Icon name="iphone" size={13} /><p>On iPhone, connect with a QR code or Ask Access. No SSH setup needed.</p></li>
+ </ul>
+ {onContinue ? <footer className="computer-access-footer">
+ <Button kind={ready ? 'primary' : 'secondary'} onClick={() => onContinue(ready)}>{ready ? 'Continue' : 'Set up later'}{ready ? <Icon name="arrow.right" size={12} /> : null}</Button>
+ </footer> : null}
</div>
</section>
)
@@ -79,10 +81,13 @@ export function ComputerAccessView({ onContinue }: { onContinue?: (ready: boolea
function AccessRow({ title, icon, detail, done, active = false, status, children }: {
title: string; icon: string; detail: string; done: boolean; active?: boolean; status?: string; children?: ReactNode
}) {
+ const label = done ? 'Ready' : status ?? (active ? 'Needs access' : 'Waiting')
return <div className={`computer-access-row ${done ? 'granted' : active ? 'current' : 'waiting'}`}>
- <span className="computer-access-row-icon"><Icon name={icon} size={17} /></span>
+ <span className="computer-access-badge" role="img" aria-label={label} title={label}>
+ {done ? <Icon name="checkmark" size={12} weight="bold" /> : <Icon name={icon} size={15} />}
+ </span>
<div className="computer-access-row-body">
- <div className="computer-access-row-heading"><h2>{title}</h2><span className="computer-access-status">{done ? <><Icon name="checkmark" size={10} weight="semibold" /> Ready</> : status ?? (active ? 'Needs access' : 'Waiting')}</span></div>
+ <h2>{title}</h2>
<p>{detail}</p>
{!done ? <div className="computer-access-actions">{children}</div> : null}
</div>
@@ -95,6 +100,12 @@ function AccessNotice({ title, icon, error = false, children }: { title: string;
</div>
}
+function SettingsHint({ app, control = false }: { app: string; control?: boolean }) {
+ return <p className="computer-access-inline-note">
+ In System Settings, look for <strong>{app}</strong>.{control ? <> It may be listed under <strong>Device Control and Data Access</strong> or <strong>Accessibility</strong>.</> : null} Return here after granting access; if asked, allow the helper to restart.
+ </p>
+}
+
function SettingsLink({ action }: { action: () => void }) {
return <Button kind="secondary" onClick={action}>Open System Settings <Icon name="arrow.up.right.square" size={10} /></Button>
}
diff --git a/apps/desktop/src/renderer/views/computer-access/computer-access.css b/apps/desktop/src/renderer/views/computer-access/computer-access.css
index 3921bf9b..e8cb5003 100644
--- a/apps/desktop/src/renderer/views/computer-access/computer-access.css
+++ b/apps/desktop/src/renderer/views/computer-access/computer-access.css
@@ -4,43 +4,44 @@
.settings-page > .computer-access { height: 100%; padding-bottom: 24px; }
.modal-content > .computer-access { flex: 1; min-height: 0; height: auto; padding-top: 20px; }
.computer-access-content { width: 100%; max-width: 520px; margin: 0 auto; }
-.computer-access-header { margin-bottom: 24px; }
+.computer-access-header { margin-bottom: 28px; }
.computer-access-identity { display: flex; align-items: center; gap: 10px; margin-bottom: 24px; }
.computer-access-identity img { flex: none; }
.computer-access-identity div { display: grid; gap: 3px; min-width: 0; }
.computer-access-identity span { color: var(--secondary); font-size: 11px; }
.computer-access-identity strong { font-size: 12px; font-weight: 500; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
.computer-access h1 { font-size: 26px; letter-spacing: -.65px; line-height: 1.2; font-weight: 600; margin: 0 0 10px; text-wrap: balance; }
-.computer-access p { color: var(--secondary); font-size: 12px; line-height: 1.6; margin: 5px 0 0; text-wrap: pretty; }
+.computer-access p { color: var(--secondary); font-size: 12px; line-height: 1.6; margin: 0; text-wrap: pretty; }
.computer-access-header > p { font-size: 13px; max-width: 480px; }
-.computer-access-section-label { display: flex; justify-content: space-between; gap: 12px; margin-bottom: 10px; font-size: 11px; color: var(--secondary); }
+.computer-access-section-label { display: flex; align-items: center; justify-content: space-between; gap: 12px; margin-bottom: 8px; font-size: 11px; color: var(--secondary); }
.computer-access-section-label > :first-child { color: var(--text); font-weight: 500; }
-/* The requested outline matches the desktop toolbar/composer treatment. */
-.computer-access-steps { border: 1px solid var(--composer-stroke); border-radius: 16px; overflow: hidden; background: var(--surface); }
-.computer-access-row { display: flex; align-items: flex-start; gap: 12px; padding: 18px; transition: background var(--fade); }
+.computer-access-section-label > :last-child { display: inline-flex; align-items: center; gap: 4px; margin-right: -4px; }
+/* The requested outline matches the desktop toolbar/composer treatment; outlined, so no fill. */
+.computer-access-steps { border: 1px solid var(--composer-stroke); border-radius: 16px; overflow: hidden; }
+.computer-access-row { display: flex; align-items: flex-start; gap: 14px; padding: 16px 18px; }
.computer-access-row + .computer-access-row { border-top: 1px solid var(--border); }
-.computer-access-row.current { background: var(--chrome-fill); }
-.computer-access-row-icon { display: flex; align-items: center; justify-content: center; width: 30px; height: 30px; flex: none; color: var(--secondary); }
-.computer-access-row.current .computer-access-row-icon, .computer-access-row.granted .computer-access-row-icon { color: var(--text); }
+/* The badge carries the state: a check when granted, the step's symbol otherwise. */
+.computer-access-badge { display: flex; align-items: center; justify-content: center; width: 28px; height: 28px; flex: none; border-radius: 50%; background: rgba(var(--text-rgb), .06); color: var(--tertiary); transition: background var(--fade), color var(--fade); }
+.computer-access-row.current .computer-access-badge { background: rgba(var(--text-rgb), .12); color: var(--text); }
+.computer-access-row.granted .computer-access-badge { background: var(--accent-fill); color: var(--on-accent); }
.computer-access-row-body { flex: 1; min-width: 0; }
-.computer-access-row-heading { display: flex; align-items: baseline; gap: 10px; justify-content: space-between; flex-wrap: wrap; }
-.computer-access h2 { font-size: 13px; line-height: 1.5; font-weight: 600; margin: 0; }
-.computer-access-status { display: inline-flex; align-items: center; gap: 5px; color: var(--secondary); font-size: 10px; line-height: 1.5; white-space: nowrap; }
-.computer-access-row.current .computer-access-status, .computer-access-row.granted .computer-access-status { color: var(--text); }
+.computer-access h2 { font-size: 13px; line-height: 28px; font-weight: 600; margin: 0; transition: color var(--fade); }
+/* A step that can't be acted on yet recedes. */
+.computer-access-row.waiting:not(:has(button)) h2 { color: var(--secondary); }
+.computer-access-row.waiting:not(:has(button)) p { color: var(--tertiary); }
.computer-access-actions { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; }
.computer-access-actions:not(:empty) { margin-top: 12px; }
.computer-access .styled-button { min-height: 30px; font-size: 11px; padding: 6px 12px; }
.computer-access .styled-button.secondary { background: transparent; border: 1px solid var(--composer-stroke); }
.computer-access .styled-button.secondary:hover:not(:disabled) { background: var(--chrome-fill); }
.computer-access .styled-button:focus-visible { outline: 2px solid var(--text); outline-offset: 3px; }
-.computer-access .computer-access-inline-note { flex-basis: 100%; margin: 0; }
-.computer-access-help, .computer-access-reassurance { display: flex; align-items: flex-start; gap: 8px; margin-top: 16px; color: var(--secondary); }
-.computer-access-help > :first-child, .computer-access-reassurance > :first-child { margin-top: 3px; }
-.computer-access-help p, .computer-access-reassurance p { margin: 0; font-size: 11px; }
-.computer-access-help strong { font-weight: 500; color: var(--text); }
-.computer-access-reassurance { margin-top: 20px; }
-.computer-access-footer { display: flex; justify-content: space-between; gap: 12px; margin-top: 22px; padding-top: 18px; border-top: 1px solid var(--border); }
-.computer-access .computer-access-phone-note { font-size: 10px; margin-top: 16px; }
+.computer-access .computer-access-inline-note { flex-basis: 100%; font-size: 11px; margin-bottom: 2px; }
+.computer-access-inline-note strong { font-weight: 500; color: var(--text); }
+.computer-access-notes { display: grid; gap: 8px; list-style: none; margin: 24px 0 0; padding: 0; color: var(--tertiary); }
+.computer-access-notes li { display: flex; align-items: flex-start; gap: 8px; }
+.computer-access-notes li > :first-child { margin-top: 2px; flex: none; }
+.computer-access .computer-access-notes p { font-size: 11px; color: var(--tertiary); }
+.computer-access-footer { display: flex; justify-content: flex-end; margin-top: 24px; }
.computer-access-notice { display: flex; align-items: flex-start; gap: 10px; border: 1px solid var(--composer-stroke); border-radius: 12px; padding: 12px 14px; margin-bottom: 20px; }
.computer-access-notice > :first-child { margin-top: 2px; color: var(--secondary); }
.computer-access-notice strong { font-size: 12px; font-weight: 500; }
@@ -49,8 +50,7 @@
.computer-access-notice.error strong, .computer-access-notice.error > :first-child { color: var(--danger); }
@media (max-width: 440px) {
.computer-access.onboarding { padding: 24px 16px; }
- .computer-access-row { padding: 14px 12px; gap: 8px; }
- .computer-access-row-heading { gap: 4px 8px; }
+ .computer-access-row { padding: 14px 12px; gap: 10px; }
.computer-access h1 { font-size: 24px; }
}
@media (prefers-reduced-motion: reduce) { .computer-access { animation: none; } }