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(apps): show each bot's agent logo when bots use different agents

leepokai69ec06b70f2b
diff --git a/apps/android/WhatsNew.md b/apps/android/WhatsNew.md
index 40b9e644..8957367e 100644
--- a/apps/android/WhatsNew.md
+++ b/apps/android/WhatsNew.md
@@ -9,6 +9,7 @@ else a generic "Bug fixes and improvements" line. Delete old sections.
## 2.38.1
### zh-Hant
+- bot 用了不只一種智慧體時,列表會在頭像左下角標出各自的智慧體標誌,可在「設定 › 外觀」關閉。
- 修正與電腦的連線中斷時,app 可能閃退的問題。
- 語音通話中語音辨識偶爾出錯時,會送出已聽到的內容並繼續聆聽,不再直接結束通話。
- 介面新增巴西葡萄牙文:可在設定選擇「Português (Brasil)」,或跟隨系統的葡萄牙文語言。
@@ -17,8 +18,9 @@ else a generic "Bug fixes and improvements" line. Delete old sections.
- 語音通話的對話紀錄更好讀,通話列在 bot 沒說話時也會顯示一排靜止的點。
### en-US
+- When bots use different agents, the bot list shows each one's logo (off in Settings › Appearance).
- Fixed a crash when the connection to your computer dropped.
-- A one-off speech recognition error in a voice call now sends what was heard and keeps listening, instead of ending the call.
+- A one-off speech recognition error no longer ends a voice call.
- Choose Português (Brasil) or Русский in Settings, or follow your system language.
-- A computer you pair by QR code that couldn't join your account at the time joins it when it next connects.
-- A call's conversation is easier to read, and the call bar shows a still row of dots while the bot isn't talking.
+- A QR-paired computer that couldn't join your account joins it when it next connects.
+- Calls read more clearly, and the call bar shows still dots while the bot is quiet.
diff --git a/apps/android/app/src/main/kotlin/com/codync/android/AppearancePreferences.kt b/apps/android/app/src/main/kotlin/com/codync/android/AppearancePreferences.kt
index 99f6efdf..8ae81d8e 100644
--- a/apps/android/app/src/main/kotlin/com/codync/android/AppearancePreferences.kt
+++ b/apps/android/app/src/main/kotlin/com/codync/android/AppearancePreferences.kt
@@ -20,15 +20,24 @@ internal object AppearancePreferences {
private var stored: SharedPreferences? = null
private val current = MutableStateFlow(Appearance.System)
val mode = current.asStateFlow()
+ private val logos = MutableStateFlow(true)
+ /** The roster marks each bot with its agent's logo while the bots run more than one agent (iOS `AgentLogos`). */
+ val agentLogos = logos.asStateFlow()
fun initialize(context: Context) {
val preferences = context.getSharedPreferences("codync-appearance", Context.MODE_PRIVATE)
stored = preferences
current.value = Appearance.entries.firstOrNull { it.value == preferences.getString("mode", null) } ?: Appearance.System
+ logos.value = preferences.getBoolean("showAgentLogos", true)
}
fun select(value: Appearance) {
stored?.edit()?.putString("mode", value.value)?.apply()
current.value = value
}
+
+ fun showAgentLogos(on: Boolean) {
+ stored?.edit()?.putBoolean("showAgentLogos", on)?.apply()
+ logos.value = on
+ }
}
diff --git a/apps/android/app/src/main/kotlin/com/codync/android/AppearanceSettings.kt b/apps/android/app/src/main/kotlin/com/codync/android/AppearanceSettings.kt
index 4143b086..d88e6300 100644
--- a/apps/android/app/src/main/kotlin/com/codync/android/AppearanceSettings.kt
+++ b/apps/android/app/src/main/kotlin/com/codync/android/AppearanceSettings.kt
@@ -10,11 +10,16 @@ import com.codync.android.design.ValueRow
@Composable
internal fun AppearanceSettings() {
val mode by AppearancePreferences.mode.collectAsStateWithLifecycle()
+ val agentLogos by AppearancePreferences.agentLogos.collectAsStateWithLifecycle()
CardSection("Appearance", "Only changes appearance on this device.") {
row {
ValueRow("Theme") {
ChoicePicker(mode, Appearance.entries.map { it to it.label }, AppearancePreferences::select, label = "Theme")
}
}
+ row {
+ SwitchRow("Show agent logos", "Marks each bot with its agent's logo when your bots use more than one agent.",
+ isOn = agentLogos, onChange = AppearancePreferences::showAgentLogos)
+ }
}
}
diff --git a/apps/android/app/src/main/kotlin/com/codync/android/BotAvatar.kt b/apps/android/app/src/main/kotlin/com/codync/android/BotAvatar.kt
index 858baff5..6d004d34 100644
--- a/apps/android/app/src/main/kotlin/com/codync/android/BotAvatar.kt
+++ b/apps/android/app/src/main/kotlin/com/codync/android/BotAvatar.kt
@@ -9,6 +9,8 @@ import androidx.compose.ui.Modifier
import androidx.compose.ui.draw.drawWithContent
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.graphics.drawscope.Stroke
+import androidx.compose.ui.semantics.contentDescription
+import androidx.compose.ui.semantics.semantics
import androidx.compose.ui.unit.Dp
import androidx.compose.ui.unit.dp
import com.codync.android.core.Bot
@@ -21,10 +23,18 @@ import com.codync.android.design.*
else CharacterAvatar(bot.avatarShape, bot.avatarColor, size, status(bot), customImage = bot.customIcon?.dataUrl, customTinted = bot.customIcon?.tinted == true)
}
-/** The roster's avatar, with its status dot (iOS `AvatarWithStatus`): amber needs you, the accent dot is unread. */
-@Composable internal fun AvatarWithStatus(bot: Bot, bots: List<Bot>, size: Dp = 44.dp) {
+/** An agent's logo for an avatar's corner: its ACP registry id, and its name for TalkBack. */
+internal class AgentMark(val registry: String, val name: String)
+
+/** The roster's avatar, with its status dot (iOS `AvatarWithStatus`): amber needs you, the accent dot is unread.
+ * [agent] puts the agent's logo in the bottom-start corner. */
+@Composable internal fun AvatarWithStatus(bot: Bot, bots: List<Bot>, size: Dp = 44.dp, agent: AgentMark? = null) {
Box(Modifier.size(size)) {
BotAvatar(bot, bots, size)
+ if (agent != null) Box(Modifier.size(size * .4f).align(Alignment.BottomStart).background(Palette.background, CircleShape)
+ .semantics { contentDescription = agent.name }, contentAlignment = Alignment.Center) {
+ AgentIcon(agent.registry, size * .28f)
+ }
if (bot.status == "needsInput") Box(Modifier.size(size * .36f).align(if (bot.lead) Alignment.TopEnd else Alignment.BottomEnd).ring()
.background(Palette.warning, CircleShape), contentAlignment = Alignment.Center) {
Symbol("exclamationmark", size = size * .24f, tint = Color.White)
diff --git a/apps/android/app/src/main/kotlin/com/codync/android/BotListView.kt b/apps/android/app/src/main/kotlin/com/codync/android/BotListView.kt
index 8b61211a..57c5943a 100644
--- a/apps/android/app/src/main/kotlin/com/codync/android/BotListView.kt
+++ b/apps/android/app/src/main/kotlin/com/codync/android/BotListView.kt
@@ -51,10 +51,13 @@ import androidx.compose.ui.semantics.stateDescription
import androidx.compose.ui.text.style.TextAlign
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.dp
+import androidx.lifecycle.compose.collectAsStateWithLifecycle
import coil3.compose.AsyncImage
import com.codync.android.core.Bot
import com.codync.android.core.ComputerSelection
import com.codync.android.core.LinkState
+import com.codync.android.core.mixesAgents
+import com.codync.android.core.runningAgent
import com.codync.android.design.*
import com.kyant.shapes.Capsule
import kotlinx.serialization.json.JsonPrimitive
@@ -126,6 +129,7 @@ private class ComputerRoster(private val context: Context, val key: String) {
}
}
val toggleSection = { name: String -> folded = if (name in folded) folded - name else folded + name; FoldedSections.save(context, folded) }
+ val agentLogos by AppearancePreferences.agentLogos.collectAsStateWithLifecycle()
val top = WindowInsets.statusBars.asPaddingValues().calculateTopPadding()
GlassStage(Modifier.fillMaxSize().background(Palette.background), chrome = {
ScrollEdge(Edge.Top, top + 64.dp)
@@ -166,7 +170,7 @@ private class ComputerRoster(private val context: Context, val key: String) {
extensions = { extensions(id) })
}
if (grouped && (movingComputer || id in collapsed)) continue
- botLines(state, store, roster, folded, grouped, RosterActions(toggleSection,
+ botLines(state, store, roster, folded, grouped, agentLogos, RosterActions(toggleSection,
rename = { name -> naming = SectionNaming("Rename section", name) { renameSection(roster, store, name, it) } },
remove = { name -> renameSection(roster, store, name, null) },
newSection = { bot -> naming = SectionNaming("New section", "") { store.setSection(bot.id, it) } },
@@ -203,11 +207,15 @@ private class RosterActions(val toggleSection: (String) -> Unit, val rename: (St
val newSection: (Bot) -> Unit, val edit: (Bot) -> Unit, val delete: (Bot) -> Unit)
/** One computer's bots: pinned ones, then each section's heading with its bots (none while folded), then the bots in no section. */
-private fun LazyListScope.botLines(state: AppState, store: AppStore, roster: ComputerRoster, folded: Set<String>, grouped: Boolean, actions: RosterActions) {
+private fun LazyListScope.botLines(state: AppState, store: AppStore, roster: ComputerRoster, folded: Set<String>, grouped: Boolean,
+ agentLogos: Boolean, actions: RosterActions) {
val id = state.computer.id
val sectionReorder = roster.sections
val reorder = roster.reorder
val sections = menuSections(state.bots)
+ // The agent's logo marks each avatar only while the computer's bots mix agents. Not before hello: it names
+ // the logos, and without it every badge would be the same generic one.
+ val logos = agentLogos && state.hello != null && roster(state.bots).mixesAgents()
items(rosterLines(reorder.shown(roster(state.bots)), folded, sectionReorder.shown, sectionReorder.dragged != null), key = { "$id:${it.key}" }) { line ->
when (line) {
// Folding drops the section's rows from the list; animateItem fades them out and slides the rest up.
@@ -220,10 +228,11 @@ private fun LazyListScope.botLines(state: AppState, store: AppStore, roster: Com
is RosterLine.Row -> {
val bot = line.bot
val lifted = reorder.dragged == bot.id
+ val agent = bot.runningAgent.takeIf { logos && bot.kind != "group" }?.let { AgentMark(agentRegistry(state, it), backendName(state, it)) }
Box(Modifier.onSizeChanged { reorder.heights[bot.id] = it.height }
.then(if (lifted) Modifier.zIndex(1f).graphicsLayer { translationY = reorder.offset; scaleX = 1.02f; scaleY = 1.02f }
else Modifier.animateItem())) {
- BotRowItem(bot, state, store, reorder.handle(bot.id) { store.reorder(it) }, sections, grouped, edit = { actions.edit(bot) },
+ BotRowItem(bot, state, store, reorder.handle(bot.id) { store.reorder(it) }, sections, grouped, agent, edit = { actions.edit(bot) },
delete = { actions.delete(bot) }, newSection = { actions.newSection(bot) })
}
}
@@ -291,9 +300,9 @@ internal fun moved(roster: List<Bot>, id: String, offset: Int): List<String>? {
private fun Bot.movesWith(other: Bot) = band == other.band && (pinned || section == other.section)
@Composable private fun BotRowItem(bot: Bot, state: AppState, store: AppStore, drag: ContextDrag, sections: List<String>, grouped: Boolean,
- edit: () -> Unit, delete: () -> Unit, newSection: () -> Unit) {
+ agent: AgentMark?, edit: () -> Unit, delete: () -> Unit, newSection: () -> Unit) {
Box(Modifier.fillMaxWidth().contextActions(onClick = { store.openBot(bot.id) }, reorder = drag, preview = {
- Box(Modifier.padding(horizontal = 8.dp)) { BotRow(bot, state) }
+ Box(Modifier.padding(horizontal = 8.dp)) { BotRow(bot, state, agent) }
}) {
listOfNotNull(
MenuItem(if (bot.pinned) "Unpin" else "Pin", icon = if (bot.pinned) "pin.slash" else "pin") {
@@ -323,15 +332,15 @@ private fun Bot.movesWith(other: Bot) = band == other.band && (pinned || section
CustomAccessibilityAction(title) { moved(roster(state.bots), bot.id, offset)?.let(store::reorder) != null }
}
}) {
- BotRow(bot, state)
+ BotRow(bot, state, agent)
}
}
-/** One bot: avatar with its status dot, name and day, then the live activity or last message. */
-@Composable internal fun BotRow(bot: Bot, state: AppState) {
+/** One bot: avatar with its status dot (and [agent]'s logo, if any), name and day, then the live activity or last message. */
+@Composable internal fun BotRow(bot: Bot, state: AppState, agent: AgentMark? = null) {
Row(Modifier.fillMaxWidth().padding(vertical = 10.dp), verticalAlignment = Alignment.CenterVertically,
horizontalArrangement = Arrangement.spacedBy(12.dp)) {
- AvatarWithStatus(bot, state.bots, 46.dp)
+ AvatarWithStatus(bot, state.bots, 46.dp, agent)
Column(Modifier.weight(1f), verticalArrangement = Arrangement.spacedBy(4.dp)) {
Row(verticalAlignment = Alignment.CenterVertically) {
Row(Modifier.weight(1f), verticalAlignment = Alignment.CenterVertically, horizontalArrangement = Arrangement.spacedBy(6.dp)) {
diff --git a/apps/android/core/src/main/kotlin/com/codync/android/core/Fallbacks.kt b/apps/android/core/src/main/kotlin/com/codync/android/core/Fallbacks.kt
index a614a020..8222c479 100644
--- a/apps/android/core/src/main/kotlin/com/codync/android/core/Fallbacks.kt
+++ b/apps/android/core/src/main/kotlin/com/codync/android/core/Fallbacks.kt
@@ -10,6 +10,12 @@ data class Fallback(val backend: String = "", val command: String? = null, val m
@Serializable
data class AgentStep(val step: Int = 0, val agent: String = "", val model: String? = null, val since: Long = 0, val reason: String? = null)
+/** The agent the bot runs on right now: its fallback's while it's on one. */
+val Bot.runningAgent: String get() = agentStep?.agent ?: backend
+
+/** The bots run more than one agent, so the roster marks each with its agent's logo. */
+fun List<Bot>.mixesAgents(): Boolean = filter { it.kind != "group" }.mapTo(HashSet()) { it.runningAgent }.size > 1
+
/** An agent of a bot's chain that rests until `until` (ms): `usageLimit`, `rateLimited`, `signedOut`… */
@Serializable
data class Resting(val agent: String = "", val until: Long = 0, val reason: String = "") {
diff --git a/apps/android/core/src/test/kotlin/com/codync/android/core/FallbacksTest.kt b/apps/android/core/src/test/kotlin/com/codync/android/core/FallbacksTest.kt
index b051cae6..9e8e7d77 100644
--- a/apps/android/core/src/test/kotlin/com/codync/android/core/FallbacksTest.kt
+++ b/apps/android/core/src/test/kotlin/com/codync/android/core/FallbacksTest.kt
@@ -21,6 +21,16 @@ class FallbacksTest {
assertNull(old.fallbacks); assertNull(old.selfFallbacks); assertNull(old.agentStep); assertTrue(old.resting.isEmpty())
}
+ @Test fun `bots mix agents when they run more than one, counting a fallback and leaving groups out`() {
+ fun bot(json: String) = HostClient.decode(Json.parseToJsonElement(json).jsonObject)
+ val claude = bot("""{"id":"a","name":"A","backend":"claude"}""")
+ val onCodex = bot("""{"id":"b","name":"B","backend":"claude","agentStep":{"step":1,"agent":"codex","since":1}}""")
+ val group = bot("""{"id":"g","name":"G","kind":"group","backend":"codex"}""")
+ assertEquals("codex", onCodex.runningAgent)
+ assertFalse(listOf(claude, bot("""{"id":"c","name":"C","backend":"claude"}"""), group).mixesAgents())
+ assertTrue(listOf(claude, onCodex).mixesAgents())
+ }
+
@Test fun `fallbacks move one place within the list, never past either end`() {
val list = listOf(Fallback("codex"), Fallback("gemini"), Fallback("opencode"))
assertEquals(listOf("gemini", "codex", "opencode"), list.moved(1, -1).map { it.backend })
diff --git a/apps/desktop/e2e/agent-logos.spec.ts b/apps/desktop/e2e/agent-logos.spec.ts
new file mode 100644
index 00000000..e298a55f
--- /dev/null
+++ b/apps/desktop/e2e/agent-logos.spec.ts
@@ -0,0 +1,75 @@
+import { test, expect, type Page } from '@playwright/test'
+import type { HostSnapshot } from '../src/shared/ipc.ts'
+import { attach } from './sandbox.ts'
+
+type Bridge = {
+ codync: {
+ host: {
+ snapshot(): Promise<HostSnapshot>
+ call(baseURL: string, token: string, method: string, body: unknown, timeoutMs: number): Promise<unknown>
+ }
+ }
+}
+
+/** A method on the sandbox's own host, through the bridge the renderer uses. */
+function call<T>(page: Page, method: string, body: unknown): Promise<T> {
+ return page.evaluate(async ({ method, body }) => {
+ const { host } = (window as unknown as Bridge).codync
+ const { local } = await host.snapshot()
+ if (!local) throw new Error('The sandbox host is not running.')
+ return host.call(local.baseURL, local.token, method, body, 10_000)
+ }, { method, body }) as Promise<T>
+}
+
+const createBot = async (page: Page, body: object) => (await call<{ bot: { id: string } }>(page, 'createBot', body)).bot.id
+
+async function openGeneralSettings(page: Page) {
+ await page.locator('.sidebar-account').click()
+ await page.locator('.account-panel').getByText('Settings', { exact: true }).click()
+}
+
+test('bots on different agents show their logos until Show agent logos is turned off', async () => {
+ const { browser, page } = await attach()
+ const run = Date.now()
+ const claude = `Logo Claude ${run}`
+ const codex = `Logo Codex ${run}`
+ const group = `Logo Group ${run}`
+ const made: string[] = []
+ const row = (name: string) => page.locator('[data-roster-row]').filter({ has: page.getByText(name, { exact: true }) })
+ const logos = page.locator('[data-roster-row] .avatar-agent')
+ const toggle = page.getByRole('switch').filter({ hasText: 'Show agent logos' })
+ try {
+ made.push(await createBot(page, { name: claude, backend: 'claude' }), await createBot(page, { name: codex, backend: 'codex' }))
+ made.push(await createBot(page, { name: group, kind: 'group', members: [...made] }))
+
+ await expect(row(claude).locator('.avatar-agent')).toBeVisible()
+ await expect(row(codex).locator('.avatar-agent')).toBeVisible()
+ await expect(row(group).locator('.avatar-agent')).toHaveCount(0)
+ // Screen readers hear the agent with the bot's name.
+ await expect(row(codex)).toHaveAttribute('aria-label', new RegExp(`^${codex}, Codex`))
+
+ await openGeneralSettings(page)
+ await expect(toggle).toHaveAttribute('aria-checked', 'true')
+ await toggle.click()
+ await expect(toggle).toHaveAttribute('aria-checked', 'false')
+ await expect(logos).toHaveCount(0)
+ await expect(row(codex)).toHaveAttribute('aria-label', new RegExp(`^${codex}(, on |$)`))
+
+ // The choice is kept on this device.
+ await page.reload()
+ await expect(row(codex)).toBeVisible()
+ await openGeneralSettings(page)
+ await expect(toggle).toHaveAttribute('aria-checked', 'false')
+ await expect(logos).toHaveCount(0)
+
+ await toggle.click()
+ await expect(row(claude).locator('.avatar-agent')).toBeVisible()
+ await expect(row(codex).locator('.avatar-agent')).toBeVisible()
+ } finally {
+ for (const id of made.reverse()) await call(page, 'deleteBot', { botId: id }).catch(() => {})
+ // Back to the default, in this window's copy too.
+ await page.evaluate(() => localStorage.removeItem('showAgentLogos'))
+ await page.reload()
+ await browser.close()
+ }
+})
diff --git a/apps/desktop/src/renderer/components/AgentIcon.tsx b/apps/desktop/src/renderer/components/AgentIcon.tsx
index d4e0fb15..b6878630 100644
--- a/apps/desktop/src/renderer/components/AgentIcon.tsx
+++ b/apps/desktop/src/renderer/components/AgentIcon.tsx
@@ -10,6 +10,23 @@ export function agentIconURL(registry: string | null | undefined) {
return registry ? (byId.get(registry) ?? null) : null
}
+/** Registry logos are one-color; paint the ones with a known brand color in it. */
+export function agentTint(registry: string | null | undefined) {
+ switch (registry) {
+ case 'claude-acp': return 'rgb(217, 120, 87)'
+ case 'gemini': return 'linear-gradient(to top right, rgb(71, 150, 227), rgb(145, 120, 199), rgb(201, 102, 115))'
+ case 'antigravity-acp': return 'rgb(66, 133, 245)'
+ case 'mistral-vibe': return 'rgb(250, 82, 15)'
+ case 'qwen-code': return 'rgb(97, 92, 237)'
+ case 'amp-acp': return 'rgb(242, 79, 64)'
+ case 'kiro': return 'rgb(143, 69, 255)'
+ case 'dsh': return 'rgb(77, 107, 254)'
+ case 'cortex-code': return 'rgb(41, 181, 232)'
+ case 'omp': return 'linear-gradient(to bottom right, rgb(237, 74, 191), rgb(155, 77, 255), rgb(90, 216, 230))'
+ default: return 'var(--text)'
+ }
+}
+
/** An agent's logo from the ACP registry, or a generic terminal when it has none. `color` may be a gradient. */
export function AgentIcon({ registry, size, color = 'currentColor' }: { registry?: string | null; size: number; color?: string }) {
const url = agentIconURL(registry)
diff --git a/apps/desktop/src/renderer/components/Avatar.tsx b/apps/desktop/src/renderer/components/Avatar.tsx
index 0d665a39..d35a4808 100644
--- a/apps/desktop/src/renderer/components/Avatar.tsx
+++ b/apps/desktop/src/renderer/components/Avatar.tsx
@@ -4,6 +4,7 @@ import { DOT_RADIUS, dotGrid } from '../lib/dot-grid'
import { avatarColor, palette, useDark, usePixelRatio, useReduceMotion } from '../lib/theme'
import { Icon } from './Icon'
import './avatar.css'
+import { AgentIcon, agentTint } from './AgentIcon'
import { LeadAgentBadge } from './LeadAgentBadge'
import { CustomIcon } from './CustomIcon'
@@ -293,11 +294,17 @@ export function BotOrGroupAvatar({ bot, members = [], size = 44, animated = true
return isGroup(bot) && !bot.customIcon ? <GroupAvatar members={members} size={size} animated={animated} /> : <BotAvatar bot={bot} size={size} animated={animated} />
}
-/** Avatar with the roster status dot: filled = unread, amber = needs you. A group shows its members. */
-export function AvatarWithStatus({ bot, members = [], size = 44 }: { bot: Bot; members?: Bot[]; size?: number }) {
+/** Avatar with the roster status dot: filled = unread, amber = needs you. A group shows its members; `agent`
+ * (a registry id) puts the agent's logo in the bottom-left corner. */
+export function AvatarWithStatus({ bot, members = [], size = 44, agent = null }: { bot: Bot; members?: Bot[]; size?: number; agent?: string | null }) {
return (
<div className={`avatar-frame ${bot.lead ? 'lead-avatar' : ''}`} style={{ width: size, height: size }}>
<BotOrGroupAvatar bot={bot} members={members} size={size} />
+ {agent ? (
+ <span className="avatar-agent" style={{ width: size * 0.4, height: size * 0.4 }}>
+ <AgentIcon registry={agent} size={size * 0.28} color={agentTint(agent)} />
+ </span>
+ ) : null}
{bot.lead ? <LeadAgentBadge size={Math.max(12, size * 0.34)} /> : null}
{needsInput(bot) ? (
<div className="avatar-badge needs-you" style={{ width: size * 0.36, height: size * 0.36 }}>
diff --git a/apps/desktop/src/renderer/components/avatar.css b/apps/desktop/src/renderer/components/avatar.css
index 9609d01f..ebbc8ffa 100644
--- a/apps/desktop/src/renderer/components/avatar.css
+++ b/apps/desktop/src/renderer/components/avatar.css
@@ -41,6 +41,16 @@
background: var(--accent-fill);
}
+.avatar-agent {
+ position: absolute;
+ left: 0;
+ bottom: 0;
+ display: grid;
+ place-items: center;
+ border-radius: 50%;
+ background: var(--background);
+}
+
.lead-agent-badge {
position: absolute;
right: 0;
diff --git a/apps/desktop/src/renderer/lib/prefs.ts b/apps/desktop/src/renderer/lib/prefs.ts
index a52156c2..87e4f067 100644
--- a/apps/desktop/src/renderer/lib/prefs.ts
+++ b/apps/desktop/src/renderer/lib/prefs.ts
@@ -73,6 +73,8 @@ export const prefs = {
rosterSectionOrder: pref<Record<string, string[]>>('rosterSectionOrder', {}),
collapsedRosterSections: pref<string[]>('collapsedRosterSections', []),
usageIconStyle: pref<'character' | 'original'>('usageIconStyle', 'character'),
+ /** The roster marks each bot with its agent's logo while the bots run more than one agent. */
+ agentLogos: pref('showAgentLogos', true),
onboardingDone: pref('macAccountOnboardingCompleted', false),
computerAccessSetup: pref<'ready' | 'later' | null>('computerAccessSetup', null),
starAsk: pref<StarAsk>('githubStarAsk', { kind: 'never' }),
diff --git a/apps/desktop/src/renderer/store/bot-mirror.ts b/apps/desktop/src/renderer/store/bot-mirror.ts
index 204399eb..183a0096 100644
--- a/apps/desktop/src/renderer/store/bot-mirror.ts
+++ b/apps/desktop/src/renderer/store/bot-mirror.ts
@@ -1,4 +1,5 @@
import { checkVersions, isBelow, type VersionMismatch } from '@shared/compat'
+import { mixesAgents } from '@shared/fallbacks'
import {
type AccessRequest,
type Bot,
@@ -186,6 +187,12 @@ export class BotMirror extends Observable {
return [...this.bots.values()].filter((b) => !b.hidden).sort(rosterOrder)
}
+ /** The visible bots run more than one agent, so the roster marks each with its agent's logo. Not before
+ * `hello`: it names the logos, and without it every badge would be the same generic one. */
+ get mixesAgents(): boolean {
+ return this.hello !== null && mixesAgents([...this.bots.values()].filter((b) => !b.hidden))
+ }
+
get hiddenBots(): Bot[] {
return [...this.bots.values()].filter((b) => b.hidden).sort((a, b) => a.name.localeCompare(b.name))
}
diff --git a/apps/desktop/src/renderer/views/BotRoster.tsx b/apps/desktop/src/renderer/views/BotRoster.tsx
index f22321a9..3b1ca4d4 100644
--- a/apps/desktop/src/renderer/views/BotRoster.tsx
+++ b/apps/desktop/src/renderer/views/BotRoster.tsx
@@ -1,8 +1,10 @@
import { useRef, useState, type ReactNode, type RefObject } from 'react'
import { createPortal } from 'react-dom'
+import { runningAgent } from '@shared/fallbacks'
import { isGroup, type Bot } from '@shared/models'
import { moveInOrder } from '../lib/computer-roster'
import { pointerDrag, type Point } from '../lib/pointer-drag'
+import { prefs, usePref } from '../lib/prefs'
import { sameRosterGroup } from '../lib/roster-sections'
import { reduceMotion } from '../lib/theme'
import { useSlide } from '../lib/slide'
@@ -46,6 +48,7 @@ export function BotRoster({ roster, compact, onContext, onSectionContext, openEx
}) {
const app = useApp()
const selected = app.selection
+ const [agentLogos] = usePref(prefs.agentLogos)
const [hovered, setHovered] = useState<string | null>(null)
const [botDrag, setBotDragState] = useState<BotDrag | null>(null)
// The drag's handlers outlive the render that started it, so they read the latest drag here.
@@ -189,12 +192,14 @@ export function BotRoster({ roster, compact, onContext, onSectionContext, openEx
// The held row shows as hovered, or as an empty slot while its lifted copy follows the pointer.
const held = botDrag?.item.bot.id === item.bot.id && botDrag.item.ref.computerId === item.ref.computerId
const many = roster.sections.length > 1
+ const agent = logoAgent(item, agentLogos)
+ const name = agent ? `${item.bot.name}, ${item.store.backendName(agent)}` : item.bot.name
return (
<RosterRow
key={key}
hovered={hovered === key || held}
compact={compact}
- label={many ? `${item.bot.name}, on ${item.store.hostName}` : item.bot.name}
+ label={many ? `${name}, on ${item.store.hostName}` : name}
title={many ? `${item.bot.name} · ${item.store.hostName}` : item.bot.name}
selected={isSelected}
dragKey={key}
@@ -204,7 +209,7 @@ export function BotRoster({ roster, compact, onContext, onSectionContext, openEx
lifted={held && lift !== null}
drag={pointerDrag({ start: (from) => liftRow(item, siblings, from), over: dragOver, drop, cancel: endDrag })}
>
- <RosterBotRow item={item} compact={compact} />
+ <RosterBotRow item={item} compact={compact} agent={agent} />
</RosterRow>
)
}
@@ -236,26 +241,31 @@ export function BotRoster({ roster, compact, onContext, onSectionContext, openEx
return (
<>
{sections}
- {lift ? <RosterGhost key={lift.seq} lift={lift} ghost={ghost} compact={compact} /> : null}
+ {lift ? <RosterGhost key={lift.seq} lift={lift} ghost={ghost} compact={compact} logos={agentLogos} /> : null}
</>
)
}
/** The lifted row or heading under the pointer (iOS's lifted cell): a smaller, translucent copy that follows it. */
-function RosterGhost({ lift, ghost, compact }: { lift: Lift; ghost: RefObject<HTMLDivElement | null>; compact: boolean }) {
+function RosterGhost({ lift, ghost, compact, logos }: { lift: Lift; ghost: RefObject<HTMLDivElement | null>; compact: boolean; logos: boolean }) {
const card = 'item' in lift.held ? `roster-row ${compact ? 'compact' : ''}` : 'computer-roster-toggle'
return createPortal(
<div ref={ghost} className="roster-ghost" style={{ width: lift.width, translate: ghostTranslate(lift.at, lift.grab) }}>
<div className={`${card} roster-ghost-card`} style={{ transformOrigin: `${lift.grab.x}px ${lift.grab.y}px` }}>
- {'item' in lift.held ? <RosterBotRow item={lift.held.item} compact={compact} /> : <ComputerHeadingLabel store={lift.held.store} compact={compact} collapsed />}
+ {'item' in lift.held ? <RosterBotRow item={lift.held.item} compact={compact} agent={logoAgent(lift.held.item, logos)} /> : <ComputerHeadingLabel store={lift.held.store} compact={compact} collapsed />}
</div>
</div>,
document.body,
)
}
-function RosterBotRow({ item, compact }: { item: RosterItem; compact: boolean }) {
- return <BotRow bot={item.bot} store={item.store} compact={compact} usingComputer={item.store.screen?.agentBot === item.bot.id} members={isGroup(item.bot) ? item.store.members(item.bot) : noMembers} />
+/** The agent whose logo marks a bot's avatar: only while its computer's bots mix agents, and never a group's. */
+function logoAgent(item: RosterItem, logos: boolean): string | null {
+ return logos && !isGroup(item.bot) && item.store.mixesAgents ? runningAgent(item.bot) : null
+}
+
+function RosterBotRow({ item, compact, agent }: { item: RosterItem; compact: boolean; agent: string | null }) {
+ return <BotRow bot={item.bot} store={item.store} compact={compact} usingComputer={item.store.screen?.agentBot === item.bot.id} members={isGroup(item.bot) ? item.store.members(item.bot) : noMembers} agent={agent} />
}
/** One roster button: drags to reorder, and slides when the others move. */
diff --git a/apps/desktop/src/renderer/views/BotRow.tsx b/apps/desktop/src/renderer/views/BotRow.tsx
index f6ecca3b..adecaae3 100644
--- a/apps/desktop/src/renderer/views/BotRow.tsx
+++ b/apps/desktop/src/renderer/views/BotRow.tsx
@@ -10,13 +10,14 @@ import { useModel } from '../lib/observable'
import { useTr } from '../lib/use-language'
import type { BotStore } from '../store/bot-store'
-/** A roster row: avatar with status, name, and the live activity or last message (Grok Bot's desktop sidebar). */
-export const BotRow = memo(function BotRow({ bot, store, compact, usingComputer, members }: { bot: Bot; store: BotStore; compact: boolean; usingComputer: boolean; members: Bot[] }) {
+/** A roster row: avatar with status, name, and the live activity or last message (Grok Bot's desktop sidebar).
+ * `agent` is the one whose logo marks the avatar, if any. */
+export const BotRow = memo(function BotRow({ bot, store, compact, usingComputer, members, agent }: { bot: Bot; store: BotStore; compact: boolean; usingComputer: boolean; members: Bot[]; agent: string | null }) {
// The cached roster paints before hello names the agents. Follow the store so that arrival replaces "Custom agent".
useModel(store)
return (
<HStack gap={compact ? 0 : 10} justify={compact ? 'center' : 'flex-start'} className="bot-row">
- <AvatarWithStatus bot={bot} members={members} size={30} />
+ <AvatarWithStatus bot={bot} members={members} size={30} agent={agent ? store.agentRegistry(agent) : null} />
<VStack gap={2} className={`bot-row-text ${compact ? 'collapsed' : ''}`} aria-hidden={compact}>
<HStack align="baseline" gap={4} shrink>
{bot.pinned ? <Icon name="pin.fill" size={10} color="var(--tertiary)" /> : null}
diff --git a/apps/desktop/src/renderer/views/bots/Fallbacks.tsx b/apps/desktop/src/renderer/views/bots/Fallbacks.tsx
index 19388187..c05c8fa5 100644
--- a/apps/desktop/src/renderer/views/bots/Fallbacks.tsx
+++ b/apps/desktop/src/renderer/views/bots/Fallbacks.tsx
@@ -1,5 +1,5 @@
import { useState } from 'react'
-import { MAX_FALLBACKS, moveFallback, restLine, restOf, stepBanner } from '@shared/fallbacks'
+import { MAX_FALLBACKS, moveFallback, restLine, restOf, runningAgent, stepBanner } from '@shared/fallbacks'
import type { Backend, Bot, BotDraft, Fallback } from '@shared/models'
import { AgentIcon } from '../../components/AgentIcon'
import { Button, CardForm, CardSection, DropdownMenu, IconButton } from '../../components/Controls'
@@ -25,7 +25,7 @@ export function AgentStepBanner({ bot }: { bot: Bot }) {
const store = useStore()
return (
<HStack gap={8} className="fade-in">
- <AgentIcon registry={store.agentRegistry(bot.agentStep?.agent ?? bot.backend)} size={14} />
+ <AgentIcon registry={store.agentRegistry(runningAgent(bot))} size={14} />
<Text tone="text" grow>{stepBanner(bot, (a) => store.backendName(a), Date.now())}</Text>
<Button kind="secondary" className="fallback-switch-back" onClick={() => store.switchBack(bot.id)}>Switch back</Button>
</HStack>
diff --git a/apps/desktop/src/renderer/views/marketplace/AgentSheet.tsx b/apps/desktop/src/renderer/views/marketplace/AgentSheet.tsx
index aa5a4bd3..233c3b32 100644
--- a/apps/desktop/src/renderer/views/marketplace/AgentSheet.tsx
+++ b/apps/desktop/src/renderer/views/marketplace/AgentSheet.tsx
@@ -1,6 +1,6 @@
import { useEffect, useRef, useState, type ReactNode } from 'react'
import type { Backend } from '@shared/models'
-import { AgentIcon } from '../../components/AgentIcon'
+import { AgentIcon, agentTint } from '../../components/AgentIcon'
import { Button, CardForm, CardSection, IconButton, Spinner } from '../../components/Controls'
import { Icon } from '../../components/Icon'
import { ModalHeader, SheetPage } from '../../components/Overlay'
@@ -16,23 +16,6 @@ import { SetupTerminalView } from './SetupTerminal'
type SetupRoute = { kind: 'install' } | { kind: 'node' } | { kind: 'terminal'; method: AuthMethod | null } | { kind: 'keys'; method: AuthMethod }
-/** Registry logos are one-color; paint the ones with a known brand color in it. */
-export function agentTint(registry: string | null | undefined) {
- switch (registry) {
- case 'claude-acp': return 'rgb(217, 120, 87)'
- case 'gemini': return 'linear-gradient(to top right, rgb(71, 150, 227), rgb(145, 120, 199), rgb(201, 102, 115))'
- case 'antigravity-acp': return 'rgb(66, 133, 245)'
- case 'mistral-vibe': return 'rgb(250, 82, 15)'
- case 'qwen-code': return 'rgb(97, 92, 237)'
- case 'amp-acp': return 'rgb(242, 79, 64)'
- case 'kiro': return 'rgb(143, 69, 255)'
- case 'dsh': return 'rgb(77, 107, 254)'
- case 'cortex-code': return 'rgb(41, 181, 232)'
- case 'omp': return 'linear-gradient(to bottom right, rgb(237, 74, 191), rgb(155, 77, 255), rgb(90, 216, 230))'
- default: return 'var(--text)'
- }
-}
-
/** An agent's registry logo on a rounded tile. */
export function AgentTile({ registry, icon, tile, radius }: { registry?: string | null; icon: number; tile: number; radius: number }) {
return (
diff --git a/apps/desktop/src/renderer/views/settings/SettingsView.tsx b/apps/desktop/src/renderer/views/settings/SettingsView.tsx
index f624613b..a1d31dc5 100644
--- a/apps/desktop/src/renderer/views/settings/SettingsView.tsx
+++ b/apps/desktop/src/renderer/views/settings/SettingsView.tsx
@@ -15,6 +15,7 @@ import { DEFAULT_TEXT_SIZE, prefs, TEXT_SIZES, usePref } from '../../lib/prefs'
import { useAccount } from '../../store/account'
import { useScreenViewed } from '../../store/analytics'
import { StoreContext, useApp } from '../../store/context'
+import { SwitchRow } from '../bots/parts'
import { ComputerBadge } from '../ComputerBadge'
import { UpdateButton, useUpdates } from '../UpdateButton'
import { ComputersView } from './ComputersView'
@@ -131,6 +132,7 @@ function GeneralSettings() {
const systemLanguage = typeof navigator === 'undefined' ? 'en' : navigator.language
const [usageIconStyle, setUsageIconStyle] = usePref(prefs.usageIconStyle)
const [compact, setCompact] = usePref(prefs.sidebarCompact)
+ const [agentLogos, setAgentLogos] = usePref(prefs.agentLogos)
const [thinkingDetails, setThinkingDetails] = usePref(prefs.thinkingDetails)
const [showInDock, setShowInDock] = useState(true)
useEffect(() => void window.codync.app.showInDock().then(setShowInDock), [])
@@ -191,6 +193,7 @@ function GeneralSettings() {
<Switch on={compact} onChange={setCompact}>
Compact sidebar
</Switch>
+ <SwitchRow title="Show agent logos" detail="Marks each bot with its agent's logo when your bots use more than one agent." on={agentLogos} onChange={setAgentLogos} />
</CardSection>
<CardSection
title="Language"
diff --git a/apps/desktop/src/shared/fallbacks.test.ts b/apps/desktop/src/shared/fallbacks.test.ts
index 4dd47db5..d9637b44 100644
--- a/apps/desktop/src/shared/fallbacks.test.ts
+++ b/apps/desktop/src/shared/fallbacks.test.ts
@@ -1,6 +1,6 @@
import assert from 'node:assert/strict'
import { test } from 'node:test'
-import { clockTime, moveFallback, restLine, restOf, stepBanner, withBackend } from './fallbacks.ts'
+import { clockTime, mixesAgents, moveFallback, restLine, restOf, runningAgent, stepBanner, withBackend } from './fallbacks.ts'
import { draftOf, normalizeBot } from './models.ts'
const now = new Date(2026, 9, 21, 10, 0).getTime()
@@ -68,3 +68,12 @@ test('switching harness clears its model and effort, selecting the same harness
const defaultModel = withBackend({ ...draft, model: null }, 'codex')
assert.deepEqual(defaultModel.modelOptions, {})
})
+
+test('bots mix agents when they run more than one, counting a fallback and leaving groups out', () => {
+ const claude = normalizeBot({ id: 'a', backend: 'claude' })
+ const onCodex = normalizeBot({ id: 'b', backend: 'claude', agentStep: { step: 1, agent: 'codex', model: null, since: now, reason: 'usageLimit' } })
+ const group = normalizeBot({ id: 'g', kind: 'group', backend: 'codex' })
+ assert.equal(runningAgent(onCodex), 'codex')
+ assert.equal(mixesAgents([claude, normalizeBot({ id: 'c', backend: 'claude' }), group]), false)
+ assert.equal(mixesAgents([claude, onCodex]), true)
+})
diff --git a/apps/desktop/src/shared/fallbacks.ts b/apps/desktop/src/shared/fallbacks.ts
index 62e9addc..02e2f5b8 100644
--- a/apps/desktop/src/shared/fallbacks.ts
+++ b/apps/desktop/src/shared/fallbacks.ts
@@ -1,5 +1,5 @@
import { AUTO_MODE } from './approvals.ts'
-import type { Bot, BotDraft, Fallback, Resting } from './models'
+import { isGroup, type Bot, type BotDraft, type Fallback, type Resting } from './models.ts'
/** The host refuses more. */
export const MAX_FALLBACKS = 3
@@ -8,6 +8,12 @@ export const MAX_FALLBACKS = 3
export const restOf = (bot: Bot, agent: string, now: number): Resting | null =>
bot.resting.find((r) => r.agent === agent && r.until > now) ?? null
+/** The agent a bot runs on right now: its fallback's while it's on one. */
+export const runningAgent = (bot: Bot) => bot.agentStep?.agent ?? bot.backend
+
+/** The bots run more than one agent, so the roster marks each with its agent's logo. */
+export const mixesAgents = (bots: Bot[]) => new Set(bots.filter((b) => !isGroup(b)).map(runningAgent)).size > 1
+
/** "3:00 PM" today, "Tue 3:00 PM" another day. */
export function clockTime(ms: number, now: number): string {
const at = new Date(ms)
diff --git a/apps/ios/Kit/Sources/CodyncKit/Models/AgentFallback.swift b/apps/ios/Kit/Sources/CodyncKit/Models/AgentFallback.swift
index 8f395bf8..726d103a 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Models/AgentFallback.swift
+++ b/apps/ios/Kit/Sources/CodyncKit/Models/AgentFallback.swift
@@ -40,6 +40,16 @@ public struct AgentStep: Codable, Hashable, Sendable {
public var reason: String?
}
+extension Bot {
+ /// The agent the bot runs on right now: its fallback's while it's on one.
+ public var runningAgent: String { agentStep?.agent ?? backend }
+}
+
+extension Sequence<Bot> {
+ /// The bots run more than one agent, so the roster marks each with its agent's logo.
+ public var mixesAgents: Bool { Set(filter { !$0.isGroup }.map(\.runningAgent)).count > 1 }
+}
+
/// An agent of the bot's chain (its own included) resting after it couldn't answer, until `until` (ms).
public struct AgentRest: Codable, Hashable, Sendable {
public var agent: String
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/de.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/de.json
index af0d4c38..3bc7e45e 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/de.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/de.json
@@ -1519,5 +1519,7 @@
"Code {code} copied. Paste it on the sign-in page, then Enter checks. Ctrl+X cancels.": "Code {code} kopiert. Auf der Anmeldeseite einfügen, dann mit Enter prüfen. Ctrl+X bricht ab.",
"Sign in instead of using a saved token": "Anmelden statt eines gespeicherten Tokens",
"↵ sign in instead of the token": "↵ anmelden statt Token",
- "Code {code} copied: paste it at {url}, then Enter checks. Ctrl+X cancels.": "Code {code} kopiert: auf {url} einfügen, dann mit Enter prüfen. Ctrl+X bricht ab."
+ "Code {code} copied: paste it at {url}, then Enter checks. Ctrl+X cancels.": "Code {code} kopiert: auf {url} einfügen, dann mit Enter prüfen. Ctrl+X bricht ab.",
+ "Show agent logos": "Agent-Logos anzeigen",
+ "Marks each bot with its agent's logo when your bots use more than one agent.": "Zeigt bei jedem Bot das Logo seines Agenten, wenn deine Bots mehr als einen Agenten nutzen."
}
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/es.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/es.json
index 8fbec3fc..1b03ea39 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/es.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/es.json
@@ -1519,5 +1519,7 @@
"Code {code} copied. Paste it on the sign-in page, then Enter checks. Ctrl+X cancels.": "Código {code} copiado. Pégalo en la página de inicio de sesión y luego Enter comprueba. Ctrl+X cancela.",
"Sign in instead of using a saved token": "Inicia sesión en lugar de usar un token guardado",
"↵ sign in instead of the token": "↵ iniciar sesión en lugar del token",
- "Code {code} copied: paste it at {url}, then Enter checks. Ctrl+X cancels.": "Código {code} copiado: pégalo en {url} y luego Enter comprueba. Ctrl+X cancela."
+ "Code {code} copied: paste it at {url}, then Enter checks. Ctrl+X cancels.": "Código {code} copiado: pégalo en {url} y luego Enter comprueba. Ctrl+X cancela.",
+ "Show agent logos": "Mostrar logotipos de agentes",
+ "Marks each bot with its agent's logo when your bots use more than one agent.": "Marca cada bot con el logotipo de su agente cuando tus bots usan más de un agente."
}
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/fr.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/fr.json
index 76f1b1c0..c1f214ea 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/fr.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/fr.json
@@ -1519,5 +1519,7 @@
"Code {code} copied. Paste it on the sign-in page, then Enter checks. Ctrl+X cancels.": "Code {code} copié. Collez-le sur la page de connexion, puis Entrée pour vérifier. Ctrl+X pour annuler.",
"Sign in instead of using a saved token": "Se connecter au lieu d’utiliser un jeton enregistré",
"↵ sign in instead of the token": "↵ se connecter au lieu du jeton",
- "Code {code} copied: paste it at {url}, then Enter checks. Ctrl+X cancels.": "Code {code} copié : collez-le sur {url}, puis Entrée pour vérifier. Ctrl+X pour annuler."
+ "Code {code} copied: paste it at {url}, then Enter checks. Ctrl+X cancels.": "Code {code} copié : collez-le sur {url}, puis Entrée pour vérifier. Ctrl+X pour annuler.",
+ "Show agent logos": "Afficher les logos des agents",
+ "Marks each bot with its agent's logo when your bots use more than one agent.": "Indique le logo de l'agent de chaque bot lorsque vos bots utilisent plusieurs agents."
}
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ja.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ja.json
index 11efb72a..0ffe521d 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ja.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ja.json
@@ -1519,5 +1519,7 @@
"Code {code} copied. Paste it on the sign-in page, then Enter checks. Ctrl+X cancels.": "コード {code} をコピーしました。サインイン ページに貼り付けてから Enter で確認。Ctrl+X でキャンセル。",
"Sign in instead of using a saved token": "保存したトークンの代わりにサインイン",
"↵ sign in instead of the token": "↵ トークンの代わりにサインイン",
- "Code {code} copied: paste it at {url}, then Enter checks. Ctrl+X cancels.": "コード {code} をコピーしました: {url} に貼り付けてから Enter で確認。Ctrl+X でキャンセル。"
+ "Code {code} copied: paste it at {url}, then Enter checks. Ctrl+X cancels.": "コード {code} をコピーしました: {url} に貼り付けてから Enter で確認。Ctrl+X でキャンセル。",
+ "Show agent logos": "エージェントのロゴを表示",
+ "Marks each bot with its agent's logo when your bots use more than one agent.": "複数のエージェントを使っているとき、各ボットにそのエージェントのロゴを表示します。"
}
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ko.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ko.json
index 8acd92b9..de97c08a 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ko.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ko.json
@@ -1519,5 +1519,7 @@
"Code {code} copied. Paste it on the sign-in page, then Enter checks. Ctrl+X cancels.": "코드 {code} 복사됨. 로그인 페이지에 붙여 넣은 뒤 Enter로 확인. Ctrl+X로 취소.",
"Sign in instead of using a saved token": "저장된 토큰 대신 로그인하세요",
"↵ sign in instead of the token": "↵ 토큰 대신 로그인",
- "Code {code} copied: paste it at {url}, then Enter checks. Ctrl+X cancels.": "코드 {code} 복사됨: {url}에 붙여 넣은 뒤 Enter로 확인. Ctrl+X로 취소."
+ "Code {code} copied: paste it at {url}, then Enter checks. Ctrl+X cancels.": "코드 {code} 복사됨: {url}에 붙여 넣은 뒤 Enter로 확인. Ctrl+X로 취소.",
+ "Show agent logos": "에이전트 로고 표시",
+ "Marks each bot with its agent's logo when your bots use more than one agent.": "봇이 두 가지 이상의 에이전트를 사용할 때 각 봇에 해당 에이전트의 로고를 표시합니다."
}
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/pt-BR.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/pt-BR.json
index 00003f76..9c3fafd6 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/pt-BR.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/pt-BR.json
@@ -1519,5 +1519,7 @@
"Code {code} copied. Paste it on the sign-in page, then Enter checks. Ctrl+X cancels.": "Código {code} copiado. Cole na página de login e depois pressione Enter para verificar. Ctrl+X cancela.",
"Sign in instead of using a saved token": "Entrar em vez de usar um token salvo",
"↵ sign in instead of the token": "↵ entrar em vez de usar o token",
- "Code {code} copied: paste it at {url}, then Enter checks. Ctrl+X cancels.": "Código {code} copiado: cole em {url} e depois pressione Enter para verificar. Ctrl+X cancela."
+ "Code {code} copied: paste it at {url}, then Enter checks. Ctrl+X cancels.": "Código {code} copiado: cole em {url} e depois pressione Enter para verificar. Ctrl+X cancela.",
+ "Show agent logos": "Mostrar logotipos dos agentes",
+ "Marks each bot with its agent's logo when your bots use more than one agent.": "Marca cada bot com o logotipo do agente dele quando seus bots usam mais de um agente."
}
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ru.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ru.json
index 18cbfc9c..e0c7e256 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ru.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ru.json
@@ -1519,5 +1519,7 @@
"Code {code} copied. Paste it on the sign-in page, then Enter checks. Ctrl+X cancels.": "Код {code} скопирован. Вставьте его на странице входа, затем нажмите Enter для проверки. Ctrl+X — отмена.",
"Sign in instead of using a saved token": "Войти вместо использования сохранённого токена",
"↵ sign in instead of the token": "↵ войти вместо использования токена",
- "Code {code} copied: paste it at {url}, then Enter checks. Ctrl+X cancels.": "Код {code} скопирован: вставьте его на {url}, затем нажмите Enter для проверки. Ctrl+X — отмена."
+ "Code {code} copied: paste it at {url}, then Enter checks. Ctrl+X cancels.": "Код {code} скопирован: вставьте его на {url}, затем нажмите Enter для проверки. Ctrl+X — отмена.",
+ "Show agent logos": "Показывать логотипы агентов",
+ "Marks each bot with its agent's logo when your bots use more than one agent.": "Отмечает каждого бота логотипом его агента, когда ваши боты используют больше одного агента."
}
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hans.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hans.json
index e6d043a2..120934cd 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hans.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hans.json
@@ -1519,5 +1519,7 @@
"Code {code} copied. Paste it on the sign-in page, then Enter checks. Ctrl+X cancels.": "代码 {code} 已复制。粘贴到登录页后,按 Enter 检查。Ctrl+X 取消。",
"Sign in instead of using a saved token": "改用登录,不再用已存的 token",
"↵ sign in instead of the token": "↵ 改用登录,不再用 token",
- "Code {code} copied: paste it at {url}, then Enter checks. Ctrl+X cancels.": "代码 {code} 已复制:到 {url} 粘贴后,按 Enter 检查。Ctrl+X 取消。"
+ "Code {code} copied: paste it at {url}, then Enter checks. Ctrl+X cancels.": "代码 {code} 已复制:到 {url} 粘贴后,按 Enter 检查。Ctrl+X 取消。",
+ "Show agent logos": "显示智能体标志",
+ "Marks each bot with its agent's logo when your bots use more than one agent.": "当你的 bot 使用不止一种智能体时,在每个 bot 上标出它的智能体标志。"
}
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hant.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hant.json
index 2dc7e670..8e655156 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hant.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hant.json
@@ -1519,5 +1519,7 @@
"Code {code} copied. Paste it on the sign-in page, then Enter checks. Ctrl+X cancels.": "代碼 {code} 已複製。貼到登入頁後,按 Enter 檢查。Ctrl+X 取消。",
"Sign in instead of using a saved token": "改用登入,不再用已存的 token",
"↵ sign in instead of the token": "↵ 改用登入,不再用 token",
- "Code {code} copied: paste it at {url}, then Enter checks. Ctrl+X cancels.": "代碼 {code} 已複製:到 {url} 貼上後,按 Enter 檢查。Ctrl+X 取消。"
+ "Code {code} copied: paste it at {url}, then Enter checks. Ctrl+X cancels.": "代碼 {code} 已複製:到 {url} 貼上後,按 Enter 檢查。Ctrl+X 取消。",
+ "Show agent logos": "顯示智慧體標誌",
+ "Marks each bot with its agent's logo when your bots use more than one agent.": "當你的 bot 使用不只一種智慧體時,在每個 bot 上標出它的智慧體標誌。"
}
diff --git a/apps/ios/Kit/Sources/CodyncUI/Bots/AgentBadge.swift b/apps/ios/Kit/Sources/CodyncUI/Bots/AgentBadge.swift
new file mode 100644
index 00000000..91253f76
--- /dev/null
+++ b/apps/ios/Kit/Sources/CodyncUI/Bots/AgentBadge.swift
@@ -0,0 +1,31 @@
+import CodyncKit
+import SwiftUI
+
+/// A device preference: while the computer's bots run more than one agent, the roster marks each bot with its
+/// agent's logo. On by default.
+public enum AgentLogos {
+ public static let storageKey = "showAgentLogos"
+}
+
+/// The agent's logo on a background-colored disc, for an avatar's bottom-left corner.
+struct AgentBadge: View {
+ let registry: String
+ let size: CGFloat
+
+ var body: some View {
+ AgentIcon(registry: registry, size: size * 0.7)
+ .frame(width: size, height: size)
+ .background(Palette.background, in: Circle())
+ }
+}
+
+/// Settings › Appearance: whether the roster shows agent logos on this device.
+public struct AgentLogosToggle: View {
+ @AppStorage(AgentLogos.storageKey) private var on = true
+
+ public init() {}
+
+ public var body: some View {
+ SwitchRow("Show agent logos", detail: "Marks each bot with its agent's logo when your bots use more than one agent.", isOn: $on)
+ }
+}
diff --git a/apps/ios/Kit/Sources/CodyncUI/Bots/BotRow.swift b/apps/ios/Kit/Sources/CodyncUI/Bots/BotRow.swift
index 8cf5054e..d5e256f9 100644
--- a/apps/ios/Kit/Sources/CodyncUI/Bots/BotRow.swift
+++ b/apps/ios/Kit/Sources/CodyncUI/Bots/BotRow.swift
@@ -3,9 +3,14 @@ import SwiftUI
public struct BotRow: View {
let bot: Bot
+ /// The agent whose logo marks the avatar, if any.
+ let agent: String?
@Environment(BotStore.self) private var model
- public init(bot: Bot) { self.bot = bot }
+ public init(bot: Bot, agent: String? = nil) {
+ self.bot = bot
+ self.agent = agent
+ }
private let avatar: CGFloat = 46
private let rowPadding: CGFloat = 10
@@ -14,6 +19,11 @@ public struct BotRow: View {
public var body: some View {
HStack(spacing: 12) {
AvatarWithStatus(bot: bot, members: model.members(of: bot), size: avatar)
+ .overlay(alignment: .bottomLeading) {
+ if let agent {
+ AgentBadge(registry: model.agentRegistry(agent), size: avatar * 0.4)
+ }
+ }
VStack(alignment: .leading, spacing: lineSpacing) {
HStack(alignment: .firstTextBaseline) {
if bot.pinned {
diff --git a/apps/ios/Kit/Sources/CodyncUI/Store/BotStore.swift b/apps/ios/Kit/Sources/CodyncUI/Store/BotStore.swift
index 798d43e6..f3ea386e 100644
--- a/apps/ios/Kit/Sources/CodyncUI/Store/BotStore.swift
+++ b/apps/ios/Kit/Sources/CodyncUI/Store/BotStore.swift
@@ -214,6 +214,10 @@ public final class BotStore {
}
}
+ /// The visible bots run more than one agent, so the roster marks each with its agent's logo. Not before
+ /// `hello`: it names the logos, and without it every badge would be the same generic one.
+ public var mixesAgents: Bool { hello != nil && bots.values.filter { !$0.hidden }.mixesAgents }
+
/// Every section on this computer by name, hidden and pinned bots' too (a row's "Move to section").
public var sections: [String] { RosterSection.sorted(Set(bots.values.compactMap(\.section))) }
diff --git a/apps/ios/Kit/Tests/CodyncKitTests/AgentFallbackTests.swift b/apps/ios/Kit/Tests/CodyncKitTests/AgentFallbackTests.swift
index 2b24a658..5dc13963 100644
--- a/apps/ios/Kit/Tests/CodyncKitTests/AgentFallbackTests.swift
+++ b/apps/ios/Kit/Tests/CodyncKitTests/AgentFallbackTests.swift
@@ -80,3 +80,12 @@ private func updateBody(_ draft: BotDraft) throws -> [String: Any] {
draft.setAgent("claude")
#expect(draft.model == nil && draft.modelOptions.isEmpty)
}
+
+@Test func botsMixAgentsWhenTheyRunMoreThanOneCountingFallbacksNotGroups() throws {
+ let claude = try bot(#"{"id":"a","backend":"claude"}"#)
+ let onCodex = try bot(#"{"id":"b","backend":"claude","agentStep":{"step":1,"agent":"codex","since":1}}"#)
+ let group = try bot(#"{"id":"g","kind":"group","backend":"codex"}"#)
+ #expect(onCodex.runningAgent == "codex")
+ #expect(try ![claude, bot(#"{"id":"c","backend":"claude"}"#), group].mixesAgents)
+ #expect([claude, onCodex].mixesAgents)
+}
diff --git a/apps/ios/Views/AppearanceSettings.swift b/apps/ios/Views/AppearanceSettings.swift
index abb8c6a9..83b6c2b5 100644
--- a/apps/ios/Views/AppearanceSettings.swift
+++ b/apps/ios/Views/AppearanceSettings.swift
@@ -11,6 +11,7 @@ struct AppearanceSettings: View {
ValueRow("Theme") {
ChoicePicker(selection: $appearance, options: Appearance.allCases.map { (id: $0, label: $0.label) })
}
+ AgentLogosToggle()
}
}
}
diff --git a/apps/ios/Views/BotListView.swift b/apps/ios/Views/BotListView.swift
index 442bf5f1..f070ee60 100644
--- a/apps/ios/Views/BotListView.swift
+++ b/apps/ios/Views/BotListView.swift
@@ -28,6 +28,7 @@ struct BotListView: View {
@AppStorage("collapsedRosterSections") private var collapsedRosterSections = ""
@AppStorage("rosterSectionOrder") private var sectionOrderData = Data()
+ @AppStorage(AgentLogos.storageKey) private var agentLogos = true
private var sectionOrder: RosterSectionOrder {
get { RosterSectionOrder(data: sectionOrderData) }
nonmutating set { sectionOrderData = newValue.data }
@@ -338,9 +339,12 @@ struct BotListView: View {
let bot = item.bot
let line = RosterLine.bot(item, store)
let card = RoundedRectangle(cornerRadius: 16, style: .continuous)
+ // The agent's logo marks the avatar only while the computer's bots mix agents.
+ let agent = agentLogos && !bot.isGroup && store.mixesAgents ? bot.runningAgent : nil
+ let name = agent.map { "\(bot.name), \(store.backendName($0))" } ?? bot.name
// A plain button instead of a NavigationLink: same push, no chevron.
return Button { accounts.selection = item.ref } label: {
- BotRow(bot: bot)
+ BotRow(bot: bot, agent: agent)
.environment(store)
}
.buttonStyle(.plain)
@@ -350,7 +354,7 @@ struct BotListView: View {
.contentShape([.dragPreview, .contextMenuPreview], card)
.padding(.horizontal, -8)
.itemProvider { lift(line) }
- .accessibilityLabel(accounts.computers.count > 1 ? "\(bot.name), on \(store.hostName)" : bot.name)
+ .accessibilityLabel(accounts.computers.count > 1 ? "\(name), on \(store.hostName)" : name)
.accessibilityActions {
Button(L10n.tr("Move up")) { withAnimation(Motion.reduced(Motion.layout, reduceMotion)) { store.move(bot.id, by: -1) } }
Button(L10n.tr("Move down")) { withAnimation(Motion.reduced(Motion.layout, reduceMotion)) { store.move(bot.id, by: 1) } }
diff --git a/apps/ios/WhatsNew.md b/apps/ios/WhatsNew.md
index ce9170ae..894b4e19 100644
--- a/apps/ios/WhatsNew.md
+++ b/apps/ios/WhatsNew.md
@@ -8,6 +8,7 @@ a version without one gets a generic "Bug fixes and improvements" line. Delete o
## 2.38.1
### zh-Hant
+- bot 用了不只一種智慧體時,列表會在頭像左下角標出各自的智慧體標誌,可在「設定 › 外觀」關閉。
- 修正語音通話中,bot 唸完回覆、要再聽你說話時 app 可能閃退的問題。
- 語音通話的對話紀錄更好讀:最上方顯示是跟哪個 bot、什麼時候、通話多久,語音說的話也更清楚。
- 通話列在 bot 沒說話時會顯示一排靜止的點,深色頭像的 bot 也看得到。
@@ -17,6 +18,7 @@ a version without one gets a generic "Bug fixes and improvements" line. Delete o
- 用 QR Code 配對時,如果電腦當下沒能加入你的帳號(例如手機連不上 Codync 雲端,或電腦的雲端關著),下次連上時會自動補上。
### en-US
+- When your bots use more than one agent, the bot list marks each avatar with its agent's logo. Turn it off in Settings › Appearance.
- Fixed a crash in voice calls when the bot finished reading a reply and started listening again.
- A call's conversation is easier to read: the bot, when the call ended and how long it lasted sit at the top, and the voice's words are clearer.
- The call bar shows a still row of dots while the bot isn't talking, for dark bots too.
diff --git a/apps/maestro/agent-logos.yaml b/apps/maestro/agent-logos.yaml
new file mode 100644
index 00000000..4b01b55b
--- /dev/null
+++ b/apps/maestro/agent-logos.yaml
@@ -0,0 +1,103 @@
+# Settings › Appearance › Show agent logos is on by default, and switched off it stays off after a relaunch.
+# The bot list's logos themselves are checked on the desktop (apps/desktop/e2e/agent-logos.spec.ts).
+# Needs a signed-in phone (`npm run phone-account`, docs/guides/dev-app.md), so it keeps the app's state:
+# run it apart from `smoke`, whose welcome flow clears that state.
+# Android reports the switch's state on its row, not on the row's label, and matches only `checked: true` there,
+# hence the per-platform checks.
+# One flow for iPhone and Android (docs/guides/test-stack.md):
+# maestro --device "<simulator udid>,<adb serial>" test --shard-all 2 --include-tags settings apps/maestro
+appId: com.pokai.Codync.ios.dev
+tags:
+ - settings
+---
+- runFlow:
+ when:
+ platform: iOS
+ commands:
+ - launchApp:
+ appId: com.pokai.Codync.ios.dev
+- runFlow:
+ when:
+ platform: Android
+ commands:
+ - launchApp:
+ appId: com.pokai.Codync.android.dev
+- tapOn: "Settings"
+- runFlow:
+ when:
+ platform: iOS
+ commands:
+ - assertVisible:
+ text: "Show agent logos.*"
+ checked: true
+- runFlow:
+ when:
+ platform: Android
+ commands:
+ - assertVisible:
+ containsChild: "Show agent logos"
+ checked: true
+- tapOn: "Show agent logos.*"
+- runFlow:
+ when:
+ platform: iOS
+ commands:
+ - assertVisible:
+ text: "Show agent logos.*"
+ checked: false
+- runFlow:
+ when:
+ platform: Android
+ commands:
+ - assertVisible:
+ containsChild: "Show agent logos"
+ - assertNotVisible:
+ containsChild: "Show agent logos"
+ checked: true
+- runFlow:
+ when:
+ platform: iOS
+ commands:
+ - stopApp: com.pokai.Codync.ios.dev
+ - launchApp:
+ appId: com.pokai.Codync.ios.dev
+- runFlow:
+ when:
+ platform: Android
+ commands:
+ - stopApp: com.pokai.Codync.android.dev
+ - launchApp:
+ appId: com.pokai.Codync.android.dev
+- tapOn: "Settings"
+- runFlow:
+ when:
+ platform: iOS
+ commands:
+ - assertVisible:
+ text: "Show agent logos.*"
+ checked: false
+- runFlow:
+ when:
+ platform: Android
+ commands:
+ - assertVisible:
+ containsChild: "Show agent logos"
+ - assertNotVisible:
+ containsChild: "Show agent logos"
+ checked: true
+# Back to the default.
+- tapOn: "Show agent logos.*"
+- runFlow:
+ when:
+ platform: iOS
+ commands:
+ - assertVisible:
+ text: "Show agent logos.*"
+ checked: true
+- runFlow:
+ when:
+ platform: Android
+ commands:
+ - assertVisible:
+ containsChild: "Show agent logos"
+ checked: true
diff --git a/docs/design/ui-conventions.md b/docs/design/ui-conventions.md
index 92cbd01b..1b778065 100644
--- a/docs/design/ui-conventions.md
+++ b/docs/design/ui-conventions.md
@@ -10,7 +10,7 @@ iPhone conversation scrolling leaves dragging, deceleration, and bottom rubber-b
Do not wrap those toolbar controls in `IconButtonStyle`, hand-sized rounded backgrounds or another glass effect. The account avatar is toolbar content, with the system supplying the enclosing surface. This is the explicit exception to the custom-chrome rule below.
-Connecting and reconnecting are background work. `BotStore` gives initial offline reports 1 second to recover and holds drops from online (including relay "computer offline" reports) for 5 seconds. "No access" shows immediately. Automatic read acknowledgements never open an error dialog and visible conversations are acknowledged again after reconnecting. An action taken during a reconnect (back in the foreground, a new network, a drop still inside its grace) waits for the link, up to 20 seconds, instead of failing; while one waits, headers read `Connecting…` and the conversation's connection label shows a spinner. Calls that are safe to repeat (send, stop, approvals, pin, hide, mark as read, delete) are tried again when the link drops under them. Tapping while the header says Offline because the computer can't be reached starts a fresh connection attempt and waits for it, instead of failing until the backoff gets there; a computer the relay reports as off fails at once, since the relay says when it is back. A permission card shows a spinner on the chosen option, dims the others and takes no second answer until the computer has it. The desktop app's `BotStore` (link handling in `apps/desktop/src/renderer/store/bot-sync.ts`) applies the same graces and 20-second wait. The TUI follows the same rule over loopback: a command the host can't be reached for is retried for up to 20 seconds behind its "Reconnecting…" indicator (the `hello` probe that explains an unreachable host still answers at once), and its permission cards spin on the chosen option. The "Something went wrong" dialog is left for a computer that is off, a refused device, the computer's own answers, and reconnects that outlast the wait. Background work (cloud refresh, device registration) logs connection, busy-cloud and stale-token failures instead of showing them. The iOS app disconnects only in `.background`, not `.inactive`. Connection status lives only in headers and their menus. The roster header shows a small summary (`1 connected`, `1/2 connected`, `2 offline`, or `Connecting…`). Its computer menu supports multiple selections (picking a computer or All computers leaves the menu open for the next pick), reconnect, and management. At least one available computer stays selected; if saved exclusions would hide every computer, the list falls back to all. Filters persist on the device. Bots sort in bands, the [lead bot](../features/lead-bot.md) (starred, never dragged) first, then pinned bots, then the rest; within a band, in the order the user dragged them into, then by recency ([bot order](../features/computer-order.md#bot-order)). Bots the user put in a section sit under a foldable section heading (name, count, and the unread total while folded; folded state saved on the device), with sections and the plain "Bots" group in device-local order after pinned bots (initially sections sorted by name, then Bots). A bot's long-press menu has Move to section (not the lead's); a heading's has Rename section and Remove section; a move or rename the computer refuses is put back. On iPhone, when more than one computer is shown, each computer gets a light heading (badge, name, connection, and "No bots yet" when empty) above its own bots; with one computer the list stays flat. Tapping a heading folds that computer's bots away (chevron; saved on the device). Long-press a heading to drag the computer with its bots up or down: while it is lifted every computer's bots fold into their headings, they unfold on release, and the order is saved on the device (`AccountStore.move`; VoiceOver: Move up / Move down). A bot moves only among its own computer's bots, within its band, and an unpinned bot only inside its section (pinned bots ignore sections). The desktop app's sidebar has the same headings, folding and heading drag (a lifted copy follows the pointer, plus Alt+Up/Down), and the same section headings. There are no connection banners. The compact desktop rail uses a computer icon for the same menu. Conversation headers show a small connection label; the desktop names the computer in its help text, the phones in the bot details' Settings (Workspace → Computer). Pull-to-refresh remains available on iPhone. Computer setup and access requests live under Manage computers; a phone asks an account computer for access only when the user taps Ask for access, never on its own.
+Connecting and reconnecting are background work. `BotStore` gives initial offline reports 1 second to recover and holds drops from online (including relay "computer offline" reports) for 5 seconds. "No access" shows immediately. Automatic read acknowledgements never open an error dialog and visible conversations are acknowledged again after reconnecting. An action taken during a reconnect (back in the foreground, a new network, a drop still inside its grace) waits for the link, up to 20 seconds, instead of failing; while one waits, headers read `Connecting…` and the conversation's connection label shows a spinner. Calls that are safe to repeat (send, stop, approvals, pin, hide, mark as read, delete) are tried again when the link drops under them. Tapping while the header says Offline because the computer can't be reached starts a fresh connection attempt and waits for it, instead of failing until the backoff gets there; a computer the relay reports as off fails at once, since the relay says when it is back. A permission card shows a spinner on the chosen option, dims the others and takes no second answer until the computer has it. The desktop app's `BotStore` (link handling in `apps/desktop/src/renderer/store/bot-sync.ts`) applies the same graces and 20-second wait. The TUI follows the same rule over loopback: a command the host can't be reached for is retried for up to 20 seconds behind its "Reconnecting…" indicator (the `hello` probe that explains an unreachable host still answers at once), and its permission cards spin on the chosen option. The "Something went wrong" dialog is left for a computer that is off, a refused device, the computer's own answers, and reconnects that outlast the wait. Background work (cloud refresh, device registration) logs connection, busy-cloud and stale-token failures instead of showing them. The iOS app disconnects only in `.background`, not `.inactive`. Connection status lives only in headers and their menus. The roster header shows a small summary (`1 connected`, `1/2 connected`, `2 offline`, or `Connecting…`). Its computer menu supports multiple selections (picking a computer or All computers leaves the menu open for the next pick), reconnect, and management. At least one available computer stays selected; if saved exclusions would hide every computer, the list falls back to all. Filters persist on the device. Bots sort in bands, the [lead bot](../features/lead-bot.md) (starred, never dragged) first, then pinned bots, then the rest; within a band, in the order the user dragged them into, then by recency ([bot order](../features/computer-order.md#bot-order)). Bots the user put in a section sit under a foldable section heading (name, count, and the unread total while folded; folded state saved on the device), with sections and the plain "Bots" group in device-local order after pinned bots (initially sections sorted by name, then Bots). A bot's long-press menu has Move to section (not the lead's); a heading's has Rename section and Remove section; a move or rename the computer refuses is put back. On iPhone, when more than one computer is shown, each computer gets a light heading (badge, name, connection, and "No bots yet" when empty) above its own bots; with one computer the list stays flat. Tapping a heading folds that computer's bots away (chevron; saved on the device). Long-press a heading to drag the computer with its bots up or down: while it is lifted every computer's bots fold into their headings, they unfold on release, and the order is saved on the device (`AccountStore.move`; VoiceOver: Move up / Move down). A bot moves only among its own computer's bots, within its band, and an unpinned bot only inside its section (pinned bots ignore sections). The desktop app's sidebar has the same headings, folding and heading drag (a lifted copy follows the pointer, plus Alt+Up/Down), and the same section headings. There are no connection banners. The compact desktop rail uses a computer icon for the same menu. While a computer's visible bots run more than one agent, each bot row marks its avatar's bottom-left corner with the logo of the agent it runs on right now (a fallback's while on one; groups get none); **Show agent logos** in Settings › Appearance (desktop: General › Appearance; each device's own, on by default) turns it off. The TUI shows no logos (a terminal can't draw them, and letters would be ambiguous: Claude Code, Codex, Cursor and Copilot all start with C). Conversation headers show a small connection label; the desktop names the computer in its help text, the phones in the bot details' Settings (Workspace → Computer). Pull-to-refresh remains available on iPhone. Computer setup and access requests live under Manage computers; a phone asks an account computer for access only when the user taps Ask for access, never on its own.
Sources: `apps/ios/Views/BotListView.swift`, `AccountSwitcherView.swift`, `apps/ios/Kit/Sources/CodyncUI/Thread/ThreadView.swift`, `Bots/ComputerFilterHeader.swift`, `Store/ComputerSelection.swift`, `Bots/BotRow.swift`; desktop: `apps/desktop/src/renderer/views/ChatWindow.tsx`, `ComputerFilterHeader.tsx`, `BotRow.tsx`.
diff --git a/docs/features/analytics.md b/docs/features/analytics.md
index e9abfc9f..56c706c3 100644
--- a/docs/features/analytics.md
+++ b/docs/features/analytics.md
@@ -58,6 +58,9 @@ can be traced from the events around it:
failure, its category in `error`. Never the error's message.
- **Errors**: failures that should never happen go to *Error tracking* below (`reportError` on
the host, desktop and terminal UI); crashes are already caught.
+- **Display preferences send nothing.** A device's own look (Settings › Appearance: theme, text
+ size, usage icons, compact sidebar, agent logos; thinking details) has no outcome or failure to
+ trace, so switching one is not an event.
- The *Rules* above apply: feature use only, never content. List each new event and property in
[analytics events](../reference/analytics-events.md), and check they arrive in PostHog
(`env = dev`) during the change's e2e test.
diff --git a/docs/guides/test-stack.md b/docs/guides/test-stack.md
index 5c4bb9fc..90a09199 100644
--- a/docs/guides/test-stack.md
+++ b/docs/guides/test-stack.md
@@ -24,6 +24,8 @@ maestro --device "<simulator udid>,<adb serial>" test --shard-all 2 --include-ta
The devices are the worktree's own simulator `Codync <sandbox name>` and the shared `codync_worktree` emulator, under its lock ([worktree sandboxes](dev-app.md#worktree-sandboxes)). Install the worktree's builds first: `xcodebuild … -scheme "iOS Dev" -configuration DevDebug -derivedDataPath build/dd` for the simulator, `./gradlew :app:assembleDebug` for the emulator.
+A flow past the welcome screen (`agent-logos.yaml`) needs the phone signed in with `npm run phone-account` and keeps the app's state. `welcome.yaml` (`smoke`) clears it and signs the app out, so run such a flow in a Maestro run of its own, after the sign-in.
+
Two things that look like failures but aren't the app's:
- A tag no flow carries yet makes Maestro stop with "Include / Exclude tags did not match any Flows" and exit 1. Leave out area tags that have no flows.
diff --git a/web/content/docs/bots.mdx b/web/content/docs/bots.mdx
index 8d9ef6b7..c50bd12a 100644
--- a/web/content/docs/bots.mdx
+++ b/web/content/docs/bots.mdx
@@ -44,6 +44,8 @@ You can also ask a bot in its chat to rename itself or change its own instructio
Changing the agent or the model starts a new agent session. The chat history stays.
+When a computer's bots use more than one agent, the bot list shows each bot's agent logo at the bottom-left of its avatar (the agent it runs on right now, a fallback included), so you can tell your Claude Code bots from your Codex ones at a glance. To hide the logos, turn off **Show agent logos** in Settings, under **Appearance** (desktop: **Settings → General**). It only changes the device you set it on. The terminal UI doesn't show agent logos.
+
## Workspace: its own folder or a project
The **Workspace** setting is the folder the bot starts in.