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.

fix(desktop): express host failure with the codync mascot

leepokaiba76a47332bf
diff --git a/apps/desktop/src/renderer/components/Avatar.tsx b/apps/desktop/src/renderer/components/Avatar.tsx
index 992d7813..6fd128f3 100644
--- a/apps/desktop/src/renderer/components/Avatar.tsx
+++ b/apps/desktop/src/renderer/components/Avatar.tsx
@@ -5,7 +5,7 @@ import { avatarColor, palette, useDark, usePixelRatio, useReduceMotion } from '.
import { Icon } from './Icon'
import './avatar.css'
-export type Mood = 'idle' | 'working' | 'needsInput'
+export type Mood = 'idle' | 'working' | 'needsInput' | 'failed'
/** The eight Grok Bot character silhouettes, in a w×h box. */
export function characterPath(kind: string, w: number, h: number) {
@@ -131,7 +131,7 @@ export const CharacterAvatar = memo(function CharacterAvatar({ shape, color, tin
el.height = pixels
const scale = pixels / size
const ctx = el.getContext('2d')!
- const still = mood === 'idle' || reduce
+ const still = mood === 'idle' || mood === 'failed' || reduce
// A moving character draws at 30 fps (its light turns slowly), and only while on screen.
let frame = 0
let drawn = -Infinity
@@ -188,6 +188,10 @@ export function drawCharacter(
const ll = Math.hypot(lx, ly, lz)
for (const d of dots) {
if (eyeCols.includes(d.col) && eyeRows.includes(d.row)) continue
+ // A downturned mouth, cut out of the same dot grid as the eyes.
+ const mouthCenter = Math.floor(cells / 2)
+ const mouthOffset = Math.abs(d.col - mouthCenter)
+ if (mood === 'failed' && mouthOffset <= 1 && d.row === Math.floor(cells * 0.65) + mouthOffset) continue
const u = (d.x - half) / half
const v = (half - d.y) / half
const z = Math.sqrt(Math.max(0.2, 1 - u * u - v * v))
diff --git a/apps/desktop/src/renderer/views/HostStateView.tsx b/apps/desktop/src/renderer/views/HostStateView.tsx
index a4f853d1..b4b2d856 100644
--- a/apps/desktop/src/renderer/views/HostStateView.tsx
+++ b/apps/desktop/src/renderer/views/HostStateView.tsx
@@ -1,5 +1,5 @@
import type { ReactElement } from 'react'
-import { CharacterAvatar } from '../components/Avatar'
+import { CharacterAvatar, type Mood } from '../components/Avatar'
import { Button } from '../components/Controls'
import { Icon } from '../components/Icon'
import { Text } from '../components/Text'
@@ -14,21 +14,24 @@ export function HostStateView({ compact = false }: { compact?: boolean }) {
const state = app.host.state
switch (state.kind) {
case 'notInstalled':
- return <EmptyState compact={compact} icon="desktopcomputer" title={`Set up this ${isMac ? 'Mac' : 'computer'}`} message={`Codync runs your coding agents through the host, a small background service on this ${isMac ? 'Mac' : 'computer'}.`} action={['Install host', () => window.codync.host.install()]} />
+ return <EmptyState compact={compact} icon={<HostBot compact={compact} mood="idle" />} title={`Set up this ${isMac ? 'Mac' : 'computer'}`} message={`Codync runs your coding agents through the host, a small background service on this ${isMac ? 'Mac' : 'computer'}.`} action={['Install host', () => window.codync.host.install()]} />
case 'missingBinary':
- return <EmptyState compact={compact} icon="desktopcomputer.trianglebadge.exclamationmark" title="The host is missing" message={window.codync.appScheme === 'codync-dev' ? 'Rebuild Codync Dev with its development host, then open it again.' : "This copy of Codync doesn't include codync-host. Download Codync again from codync.dev or GitHub."} />
+ return <EmptyState compact={compact} icon={<HostBot compact={compact} mood="failed" />} title="The host is missing" message={window.codync.appScheme === 'codync-dev' ? 'Rebuild Codync Dev with its development host, then open it again.' : "This copy of Codync doesn't include codync-host. Download Codync again from codync.dev or GitHub."} />
case 'failed':
- return <EmptyState compact={compact} icon="desktopcomputer.trianglebadge.exclamationmark" title="The host isn't running" message={state.message} action={['Try again', () => window.codync.host.restart()]} />
+ return <EmptyState compact={compact} icon={<HostBot compact={compact} mood="failed" />} title="The host isn't running" message={state.message} action={['Try again', () => window.codync.host.restart()]} />
default:
- return <EmptyState compact={compact} icon={<StartingBot size={compact ? 32 : 112} />} title="Starting the host…" message="This takes a few seconds." />
+ return <EmptyState compact={compact} icon={<HostBot compact={compact} mood="working" />} title="Starting the host…" message="This takes a few seconds." />
}
}
-/** The app-icon bot looking around while the host starts, like the phones' launch splash. */
-function StartingBot({ size }: { size: number }) {
+/** The app-icon bot expresses progress or failure without replacing the recovery instructions. */
+function HostBot({ compact, mood }: { compact: boolean; mood: Mood }) {
return (
- <div className="starting-bot">
- <CharacterAvatar shape="squircle" color="" tint={rgbHex(palette(useDark()).text)} size={size} mood="working" />
+ <div className={`host-state-bot is-${mood}`} aria-hidden>
+ <CharacterAvatar shape="squircle" color="" tint={rgbHex(palette(useDark()).text)} size={compact ? 32 : 112} mood={mood} />
+ {mood === 'failed' ? (
+ <span className="host-state-badge">😞</span>
+ ) : null}
</div>
)
}
diff --git a/apps/desktop/src/renderer/views/chat-window.css b/apps/desktop/src/renderer/views/chat-window.css
index dc682c57..566d44b8 100644
--- a/apps/desktop/src/renderer/views/chat-window.css
+++ b/apps/desktop/src/renderer/views/chat-window.css
@@ -25,24 +25,45 @@
.empty-state-action {
margin-top: 4px;
}
-/* The bot while the host starts pops in, then bobs (as the phones' launch splash). */
-.starting-bot {
+/* Host recovery uses the app character; only a starting host bobs. */
+.host-state-bot {
+ position: relative;
margin-bottom: 6px;
- animation: starting-bot-in 0.5s cubic-bezier(0.34, 1.56, 0.64, 1) both;
+ animation: host-state-bot-in 0.5s cubic-bezier(0.34, 1.56, 0.64, 1) both;
}
-.starting-bot > canvas {
- animation: starting-bot-bob 2.6s ease-in-out infinite;
+.host-state-bot.is-working > canvas {
+ animation: host-state-bot-bob 2.6s ease-in-out infinite;
}
-.local-recovery .starting-bot {
+.local-recovery .host-state-bot {
+ position: relative;
margin-bottom: 0;
}
-@keyframes starting-bot-in {
+.host-state-badge {
+ position: absolute;
+ right: -2px;
+ bottom: 2px;
+ display: grid;
+ place-items: center;
+ width: 28px;
+ height: 28px;
+ font-family: "Apple Color Emoji", "Segoe UI Emoji", "Noto Color Emoji", sans-serif;
+ font-size: 28px;
+ line-height: 1;
+}
+.local-recovery .host-state-badge {
+ width: 15px;
+ height: 15px;
+ font-size: 15px;
+ right: -4px;
+ bottom: -2px;
+}
+@keyframes host-state-bot-in {
from {
opacity: 0;
transform: scale(0.6);
}
}
-@keyframes starting-bot-bob {
+@keyframes host-state-bot-bob {
0%,
100% {
transform: translateY(-4px);
@@ -52,8 +73,8 @@
}
}
@media (prefers-reduced-motion: reduce) {
- .starting-bot,
- .starting-bot > canvas {
+ .host-state-bot,
+ .host-state-bot > canvas {
animation: none;
}
}
diff --git a/docs/architecture/desktop-app.md b/docs/architecture/desktop-app.md
index c828e160..495f309c 100644
--- a/docs/architecture/desktop-app.md
+++ b/docs/architecture/desktop-app.md
@@ -54,6 +54,12 @@ The TUI connects to one host at a time, so it keeps its single roster.
## Platform notes
+- **Local host recovery** uses the Codync character: looking around and bobbing while starting,
+ resting for setup, and a still frown with a disappointed-face emoji badge if the host is missing or
+ failed. Error text and install/retry actions remain available in both full-window and compact
+ recovery layouts. Reduced motion removes the animation. This screen belongs to the desktop
+ service manager; iOS, Android and the TUI connect to hosts but do not install or start that service.
+
- **SSH startup** in the shared desktop UI keeps the workspace open whenever saved profiles
exist. With no online computer, the detail pane shows each profile's connection
progress, failures, reconnect and host-key confirmation controls, plus local host