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(ui): mark lead agents with gold avatar badges

leepokai9d3e1fd12466
diff --git a/apps/android/WhatsNew.md b/apps/android/WhatsNew.md
index b948318f..b1f414ba 100644
--- a/apps/android/WhatsNew.md
+++ b/apps/android/WhatsNew.md
@@ -17,6 +17,14 @@ else a generic "Bug fixes and improvements" line. Delete old sections.
- Bots can ask bots on your other computers once they share a network.
- ChatGPT or Claude can give your bots tasks through the Codync connector.
+## 2.27.1
+
+### zh-Hant
+- 主助理的頭像右下角新增金色星星;點一下詳細頁的星星,即可了解它如何追蹤目標、協調 bots 與定時關心進度。
+
+### en-US
+- Your lead agent now has a gold star on its avatar. Tap the larger star in its details to learn how it follows your goals, coordinates bots, and checks in.
+
## 2.27.0
### zh-Hant
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 aac3c74b..c596472b 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,7 +9,6 @@ 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.clearAndSetSemantics
import androidx.compose.ui.unit.Dp
import androidx.compose.ui.unit.dp
import com.codync.android.core.Bot
@@ -23,12 +22,13 @@ import com.codync.android.design.*
/** 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) {
- Box(Modifier.size(size).clearAndSetSemantics { }) {
+ Box(Modifier.size(size)) {
BotAvatar(bot, bots, size)
- if (bot.status == "needsInput") Box(Modifier.size(size * .36f).align(Alignment.BottomEnd).ring()
+ 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)
- } else if (bot.unread > 0) Box(Modifier.size(size * .28f).align(Alignment.BottomEnd).ring().background(Palette.accentFill, CircleShape))
+ } else if (bot.unread > 0) Box(Modifier.size(size * .28f).align(if (bot.lead) Alignment.TopEnd else Alignment.BottomEnd).ring().background(Palette.accentFill, CircleShape))
+ if (bot.lead) Box(Modifier.align(Alignment.BottomEnd)) { LeadAgentBadge(size * .34f) }
}
}
diff --git a/apps/android/app/src/main/kotlin/com/codync/android/BotDetailsView.kt b/apps/android/app/src/main/kotlin/com/codync/android/BotDetailsView.kt
index cb4be91f..976c9784 100644
--- a/apps/android/app/src/main/kotlin/com/codync/android/BotDetailsView.kt
+++ b/apps/android/app/src/main/kotlin/com/codync/android/BotDetailsView.kt
@@ -100,7 +100,12 @@ internal data class DetailsRequest(val tab: DetailsTab = DetailsTab.Details, val
/** The bot's avatar and name, and what runs it. */
@Composable private fun Identity(bot: Bot, state: AppState) {
Column(Modifier.fillMaxWidth().padding(top = 64.dp), horizontalAlignment = Alignment.CenterHorizontally, verticalArrangement = Arrangement.spacedBy(4.dp)) {
- Box(Modifier.padding(bottom = 10.dp)) { BotAvatar(bot, state.bots, 72.dp) }
+ Box(Modifier.padding(bottom = 10.dp)) {
+ BotAvatar(bot, state.bots, 72.dp)
+ if (bot.lead) Box(Modifier.align(Alignment.BottomEnd).size(28.dp), contentAlignment = Alignment.Center) {
+ LeadAgentBadge(28.dp, interactive = true)
+ }
+ }
Text(bot.name, style = Type.title3.semibold, color = Palette.text, textAlign = TextAlign.Center)
Row(verticalAlignment = Alignment.CenterVertically, horizontalArrangement = Arrangement.spacedBy(5.dp)) {
AgentIcon(agentRegistry(state, bot.backend), 13.dp)
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 033c3ba6..ce162bbe 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
@@ -205,8 +205,7 @@ internal fun moved(roster: List<Bot>, id: String, offset: Int): List<String>? {
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)) {
- if (bot.lead) Symbol("star.fill", size = 13.dp, tint = Palette.tertiary, contentDescription = tr("Lead bot"))
- else if (bot.pinned) Symbol("pin.fill", size = 13.dp, tint = Palette.tertiary)
+ if (bot.pinned && !bot.lead) Symbol("pin.fill", size = 13.dp, tint = Palette.tertiary)
Text(bot.name, Modifier.weight(1f, fill = false), style = Type.body.semibold, color = Palette.text, maxLines = 1,
overflow = TextOverflow.Ellipsis)
}
diff --git a/apps/android/app/src/main/kotlin/com/codync/android/LeadAgentBadge.kt b/apps/android/app/src/main/kotlin/com/codync/android/LeadAgentBadge.kt
new file mode 100644
index 00000000..26d5c6fe
--- /dev/null
+++ b/apps/android/app/src/main/kotlin/com/codync/android/LeadAgentBadge.kt
@@ -0,0 +1,36 @@
+package com.codync.android
+
+import androidx.compose.foundation.background
+import androidx.compose.foundation.rememberScrollState
+import androidx.compose.foundation.verticalScroll
+import androidx.compose.material3.Text
+import androidx.compose.foundation.layout.*
+import androidx.compose.foundation.shape.CircleShape
+import androidx.compose.runtime.*
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.Color
+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.design.*
+
+@Composable internal fun LeadAgentBadge(size: Dp, interactive: Boolean = false) {
+ var showingRole by remember { mutableStateOf(false) }
+ val label = tr(if (interactive) "About the lead agent" else "Lead agent")
+ val target = if (interactive) Modifier.requiredSize(44.dp).plainButton { showingRole = true } else Modifier.size(size)
+ Box(target.semantics { contentDescription = label }, contentAlignment = Alignment.Center) {
+ Box(Modifier.size(size).background(Palette.warning, CircleShape), contentAlignment = Alignment.Center) {
+ Symbol("star.fill", size = size * .58f, tint = Color.White)
+ }
+ }
+ if (interactive) CodyncSheet(showingRole, { showingRole = false }) {
+ Column(Modifier.fillMaxSize().background(Palette.background)) {
+ ModalHeader("Lead agent")
+ Column(Modifier.weight(1f).verticalScroll(rememberScrollState()).padding(20.dp)) {
+ Text(tr("Your lead agent is your first point of contact. It follows your goals and unfinished tasks, suggests useful next steps, and coordinates work with your other bots. Its Check in routine runs twice a day by default; you can change or pause it in Routines."), style = Type.body, color = Palette.secondary)
+ }
+ }
+ }
+}
diff --git a/apps/desktop/src/renderer/components/Avatar.tsx b/apps/desktop/src/renderer/components/Avatar.tsx
index da600d38..f3719e93 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 { LeadAgentBadge } from './LeadAgentBadge'
export type Mood = 'idle' | 'working' | 'needsInput' | 'failed'
@@ -281,8 +282,9 @@ export function GroupAvatar({ members, size = 40, animated = true }: { members:
/** 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 }) {
return (
- <div className="avatar-frame" style={{ width: size, height: size }}>
+ <div className={`avatar-frame ${bot.lead ? 'lead-avatar' : ''}`} style={{ width: size, height: size }}>
{isGroup(bot) ? <GroupAvatar members={members} size={size} /> : <BotAvatar bot={bot} size={size} />}
+ {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 }}>
<Icon name="exclamationmark" size={size * 0.2} weight="black" scaled={false} />
diff --git a/apps/desktop/src/renderer/components/LeadAgentBadge.tsx b/apps/desktop/src/renderer/components/LeadAgentBadge.tsx
new file mode 100644
index 00000000..a7015d26
--- /dev/null
+++ b/apps/desktop/src/renderer/components/LeadAgentBadge.tsx
@@ -0,0 +1,20 @@
+import { useState } from 'react'
+import { useTr } from '../lib/use-language'
+import { Icon } from './Icon'
+import { Dialog } from './Overlay'
+
+const leadAgentDescription = 'Your lead agent is your first point of contact. It follows your goals and unfinished tasks, suggests useful next steps, and coordinates work with your other bots. Its Check in routine runs twice a day by default; you can change or pause it in Routines.'
+
+/** The roster badge is decorative; the larger details badge opens the role explanation. */
+export function LeadAgentBadge({ size, interactive = false }: { size: number; interactive?: boolean }) {
+ const tr = useTr()
+ const [open, setOpen] = useState(false)
+ const star = <Icon name="star.fill" size={size * 0.58} color="white" style={{ fill: 'white' }} scaled={false} />
+ const style = { width: size, height: size }
+ if (!interactive) return <span className="lead-agent-badge" style={style} role="img" aria-label={tr('Lead agent')}>{star}</span>
+ return <>
+ <button type="button" className="lead-agent-badge interactive" style={style} aria-label={tr('About the lead agent')}
+ onClick={() => setOpen(true)}>{star}</button>
+ <Dialog open={open} title={tr('Lead agent')} message={tr(leadAgentDescription)} actions={[]} cancel="Done" onClose={() => setOpen(false)} />
+ </>
+}
diff --git a/apps/desktop/src/renderer/components/avatar.css b/apps/desktop/src/renderer/components/avatar.css
index e1b1508b..9609d01f 100644
--- a/apps/desktop/src/renderer/components/avatar.css
+++ b/apps/desktop/src/renderer/components/avatar.css
@@ -40,3 +40,25 @@
.avatar-badge.unread {
background: var(--accent-fill);
}
+
+.lead-agent-badge {
+ position: absolute;
+ right: 0;
+ bottom: 0;
+ display: grid;
+ place-items: center;
+ padding: 0;
+ border: 0;
+ border-radius: 50%;
+ background: var(--warning);
+ color: white;
+}
+.lead-agent-badge.interactive { cursor: pointer; }
+.lead-agent-badge.interactive::after {
+ content: '';
+ position: absolute;
+ inset: -10px;
+ border-radius: 50%;
+}
+.lead-agent-badge.interactive:focus-visible { outline: 2px solid var(--text); outline-offset: 3px; }
+.lead-avatar > .avatar-badge { bottom: auto; top: 0; }
diff --git a/apps/desktop/src/renderer/views/BotRow.tsx b/apps/desktop/src/renderer/views/BotRow.tsx
index 32ccb7a5..dabbfed3 100644
--- a/apps/desktop/src/renderer/views/BotRow.tsx
+++ b/apps/desktop/src/renderer/views/BotRow.tsx
@@ -14,13 +14,12 @@ import type { BotStore } from '../store/bot-store'
export const BotRow = memo(function BotRow({ bot, store, compact, usingComputer, members }: { bot: Bot; store: BotStore; compact: boolean; usingComputer: boolean; members: Bot[] }) {
// The cached roster paints before hello names the agents. Follow the store so that arrival replaces "Custom agent".
useModel(store)
- const tr = useTr()
return (
<HStack gap={compact ? 0 : 10} justify={compact ? 'center' : 'flex-start'} className="bot-row">
<AvatarWithStatus bot={bot} members={members} size={30} />
<VStack gap={2} className={`bot-row-text ${compact ? 'collapsed' : ''}`} aria-hidden={compact}>
<HStack align="baseline" gap={4} shrink>
- {bot.lead ? <Icon name="star.fill" size={10} color="var(--tertiary)" title={tr('Lead bot')} /> : bot.pinned ? <Icon name="pin.fill" size={10} color="var(--tertiary)" /> : null}
+ {!bot.lead && bot.pinned ? <Icon name="pin.fill" size={10} color="var(--tertiary)" /> : null}
<Text size="body" weight={bot.unread > 0 ? 'semibold' : 'medium'} tone="text" truncate>{bot.name}</Text>
{usingComputer ? <Icon name="cursorarrow.motionlines" size={10} color="var(--accent)" title="Using the computer" /> : null}
</HStack>
diff --git a/apps/desktop/src/renderer/views/thread/DetailsPanel.tsx b/apps/desktop/src/renderer/views/thread/DetailsPanel.tsx
index c7a3df6b..2e0704fd 100644
--- a/apps/desktop/src/renderer/views/thread/DetailsPanel.tsx
+++ b/apps/desktop/src/renderer/views/thread/DetailsPanel.tsx
@@ -3,6 +3,7 @@ import { isGroup, isWorking, type Bot } from '@shared/models'
import { AgentIcon } from '../../components/AgentIcon'
import { BotAvatar, GroupAvatar } from '../../components/Avatar'
import { IconButton, RowLabel, Switch, TabChoice } from '../../components/Controls'
+import { LeadAgentBadge } from '../../components/LeadAgentBadge'
import { Icon } from '../../components/Icon'
import { HStack, VStack } from '../../components/Stack'
import { Text } from '../../components/Text'
@@ -84,7 +85,7 @@ function Identity({ bot }: { bot: Bot }) {
const group = isGroup(bot)
return (
<div className="details-identity">
- {group ? <GroupAvatar members={store.members(bot)} size={60} /> : <BotAvatar bot={bot} size={60} />}
+ {group ? <GroupAvatar members={store.members(bot)} size={60} /> : <div className="avatar-frame"><BotAvatar bot={bot} size={60} />{bot.lead ? <LeadAgentBadge size={24} interactive /> : null}</div>}
<span className="details-name">{bot.name}</span>
<span className="details-subtitle">
{group ? (
diff --git a/apps/ios/Kit/Sources/CodyncKit/Design/CharacterAvatar.swift b/apps/ios/Kit/Sources/CodyncKit/Design/CharacterAvatar.swift
index 33eb0585..e98c7c9d 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Design/CharacterAvatar.swift
+++ b/apps/ios/Kit/Sources/CodyncKit/Design/CharacterAvatar.swift
@@ -328,7 +328,7 @@ public struct AvatarWithStatus: View {
Group {
if bot.isGroup { GroupAvatar(members: members, size: size) } else { CharacterAvatar(bot: bot, size: size) }
}
- .overlay(alignment: .bottomTrailing) {
+ .overlay(alignment: bot.lead ? .topTrailing : .bottomTrailing) {
if bot.needsInput {
Image(systemName: "exclamationmark")
.font(.system(size: size * 0.2, weight: .black))
@@ -343,5 +343,8 @@ public struct AvatarWithStatus: View {
.overlay(Circle().stroke(Palette.background, lineWidth: 2))
}
}
+ .overlay(alignment: .bottomTrailing) {
+ if bot.lead { LeadAgentBadge(size: max(12, size * 0.34)) }
+ }
}
}
diff --git a/apps/ios/Kit/Sources/CodyncKit/Design/LeadAgentBadge.swift b/apps/ios/Kit/Sources/CodyncKit/Design/LeadAgentBadge.swift
new file mode 100644
index 00000000..8d5dd412
--- /dev/null
+++ b/apps/ios/Kit/Sources/CodyncKit/Design/LeadAgentBadge.swift
@@ -0,0 +1,15 @@
+import SwiftUI
+
+public struct LeadAgentBadge: View {
+ let size: CGFloat
+ public init(size: CGFloat) { self.size = size }
+
+ public var body: some View {
+ Image(systemName: "star.fill")
+ .font(.system(size: size * 0.58, weight: .semibold))
+ .foregroundStyle(.white)
+ .frame(width: size, height: size)
+ .background(Palette.warning, in: Circle())
+ .accessibilityLabel(L10n.tr("Lead agent"))
+ }
+}
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/de.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/de.json
index 950176f4..b57789b4 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/de.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/de.json
@@ -96,6 +96,10 @@
"Language": "Sprache",
"Large": "Groß",
"Lead bot": "Haupt-Bot",
+ "Lead agent": "Leitender Agent",
+ "About the lead agent": "Über den leitenden Agenten",
+ "↑↓ scroll · esc close": "↑↓ scrollen · esc schließen",
+ "Your lead agent is your first point of contact. It follows your goals and unfinished tasks, suggests useful next steps, and coordinates work with your other bots. Its Check in routine runs twice a day by default; you can change or pause it in Routines.": "Ihr leitender Agent ist Ihre erste Anlaufstelle. Er verfolgt Ihre Ziele und offenen Aufgaben, schlägt hilfreiche nächste Schritte vor und koordiniert die Arbeit mit Ihren anderen Bots. Seine Check in-Routine läuft standardmäßig zweimal täglich; unter Routinen können Sie sie ändern oder pausieren.",
"The lead bot can't be deleted": "Der Haupt-Bot kann nicht gelöscht werden",
"The lead bot always stays on top": "Der Haupt-Bot bleibt immer oben",
"Linux": "Linux",
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/es.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/es.json
index e12d4a41..45064a08 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/es.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/es.json
@@ -96,6 +96,10 @@
"Language": "Idioma",
"Large": "Grande",
"Lead bot": "Bot principal",
+ "Lead agent": "Agente principal",
+ "About the lead agent": "Acerca del agente principal",
+ "↑↓ scroll · esc close": "↑↓ desplazar · esc cerrar",
+ "Your lead agent is your first point of contact. It follows your goals and unfinished tasks, suggests useful next steps, and coordinates work with your other bots. Its Check in routine runs twice a day by default; you can change or pause it in Routines.": "Tu agente principal es tu primer punto de contacto. Sigue tus objetivos y tareas pendientes, sugiere próximos pasos útiles y coordina el trabajo con tus otros bots. Su rutina Check in se ejecuta dos veces al día de forma predeterminada; puedes cambiarla o pausarla en Rutinas.",
"The lead bot can't be deleted": "El bot principal no se puede eliminar",
"The lead bot always stays on top": "El bot principal siempre queda arriba",
"Linux": "Linux",
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/fr.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/fr.json
index 41443912..e82e7416 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/fr.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/fr.json
@@ -96,6 +96,10 @@
"Language": "Langue",
"Large": "Grand",
"Lead bot": "Bot principal",
+ "Lead agent": "Agent principal",
+ "About the lead agent": "À propos de l’agent principal",
+ "↑↓ scroll · esc close": "↑↓ défiler · esc fermer",
+ "Your lead agent is your first point of contact. It follows your goals and unfinished tasks, suggests useful next steps, and coordinates work with your other bots. Its Check in routine runs twice a day by default; you can change or pause it in Routines.": "Votre agent principal est votre premier interlocuteur. Il suit vos objectifs et vos tâches inachevées, propose les prochaines étapes utiles et coordonne le travail avec vos autres bots. Sa routine Check in s’exécute deux fois par jour par défaut ; vous pouvez la modifier ou la suspendre dans Routines.",
"The lead bot can't be deleted": "Le bot principal ne peut pas être supprimé",
"The lead bot always stays on top": "Le bot principal reste toujours en haut",
"Linux": "Linux",
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ja.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ja.json
index d736e8c1..748a44c8 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ja.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ja.json
@@ -96,6 +96,10 @@
"Language": "言語",
"Large": "大きい",
"Lead bot": "メインボット",
+ "Lead agent": "リードエージェント",
+ "About the lead agent": "リードエージェントについて",
+ "↑↓ scroll · esc close": "↑↓ スクロール · esc 閉じる",
+ "Your lead agent is your first point of contact. It follows your goals and unfinished tasks, suggests useful next steps, and coordinates work with your other bots. Its Check in routine runs twice a day by default; you can change or pause it in Routines.": "リードエージェントは最初の相談相手です。目標や未完了のタスクを追跡し、役立つ次の一歩を提案して、他のボットとの作業を調整します。「Check in」ルーチンは初期設定で1日2回実行されます。ルーチンで変更または一時停止できます。",
"The lead bot can't be deleted": "メインボットは削除できません",
"The lead bot always stays on top": "メインボットは常に一番上です",
"Linux": "Linux",
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ko.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ko.json
index 18189827..713772e5 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ko.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ko.json
@@ -96,6 +96,10 @@
"Language": "언어",
"Large": "큼",
"Lead bot": "메인 봇",
+ "Lead agent": "리드 에이전트",
+ "About the lead agent": "리드 에이전트 소개",
+ "↑↓ scroll · esc close": "↑↓ 스크롤 · esc 닫기",
+ "Your lead agent is your first point of contact. It follows your goals and unfinished tasks, suggests useful next steps, and coordinates work with your other bots. Its Check in routine runs twice a day by default; you can change or pause it in Routines.": "리드 에이전트는 가장 먼저 연락할 도우미입니다. 목표와 미완료 작업을 추적하고 유용한 다음 단계를 제안하며 다른 봇과 작업을 조율합니다. Check in 루틴은 기본적으로 하루 두 번 실행되며, 루틴에서 변경하거나 일시 중지할 수 있습니다.",
"The lead bot can't be deleted": "메인 봇은 삭제할 수 없습니다",
"The lead bot always stays on top": "메인 봇은 항상 맨 위에 있습니다",
"Linux": "Linux",
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 fef75fec..0a5776e2 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hans.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hans.json
@@ -96,6 +96,10 @@
"Language": "语言",
"Large": "大",
"Lead bot": "主助理",
+ "Lead agent": "主助理(Lead agent)",
+ "About the lead agent": "关于主助理",
+ "↑↓ scroll · esc close": "↑↓ 滚动 · esc 关闭",
+ "Your lead agent is your first point of contact. It follows your goals and unfinished tasks, suggests useful next steps, and coordinates work with your other bots. Its Check in routine runs twice a day by default; you can change or pause it in Routines.": "主助理是你优先联系的 agent。它会跟进你的目标与未完成的任务、建议实用的下一步,并协调其他 bots 一起完成工作。它的「Check in」例行任务默认每天执行两次;你可以在「例行任务」中调整或暂停。",
"The lead bot can't be deleted": "主助理不能删除",
"The lead bot always stays on top": "主助理固定在最上面",
"Linux": "Linux",
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 b8485d4f..73ee26a7 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hant.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hant.json
@@ -96,6 +96,10 @@
"Language": "語言",
"Large": "大",
"Lead bot": "主助理",
+ "Lead agent": "主助理(Lead agent)",
+ "About the lead agent": "關於主助理",
+ "↑↓ scroll · esc close": "↑↓ 捲動 · esc 關閉",
+ "Your lead agent is your first point of contact. It follows your goals and unfinished tasks, suggests useful next steps, and coordinates work with your other bots. Its Check in routine runs twice a day by default; you can change or pause it in Routines.": "主助理是你優先聯絡的 agent。它會追蹤你的目標與未完成的任務、建議實用的下一步,並協調其他 bots 一起完成工作。它的「Check in」例行任務預設每天執行兩次;你可以在「例行任務」中調整或暫停。",
"The lead bot can't be deleted": "主助理不能刪除",
"The lead bot always stays on top": "主助理固定在最上面",
"Linux": "Linux",
diff --git a/apps/ios/Kit/Sources/CodyncUI/Bots/BotDetailsView.swift b/apps/ios/Kit/Sources/CodyncUI/Bots/BotDetailsView.swift
index 8d77f78e..484bba2b 100644
--- a/apps/ios/Kit/Sources/CodyncUI/Bots/BotDetailsView.swift
+++ b/apps/ios/Kit/Sources/CodyncUI/Bots/BotDetailsView.swift
@@ -97,7 +97,7 @@ struct BotDetailsView: View {
/// The bot's avatar and name, and what runs it.
private func identity(_ bot: Bot) -> some View {
VStack(spacing: 4) {
- CharacterAvatar(bot: bot, size: 72)
+ LeadAgentAvatar(bot: bot)
.padding(.bottom, 10)
Text(bot.name)
.font(.title3.weight(.semibold))
diff --git a/apps/ios/Kit/Sources/CodyncUI/Bots/BotRow.swift b/apps/ios/Kit/Sources/CodyncUI/Bots/BotRow.swift
index bd9eb339..03c61c99 100644
--- a/apps/ios/Kit/Sources/CodyncUI/Bots/BotRow.swift
+++ b/apps/ios/Kit/Sources/CodyncUI/Bots/BotRow.swift
@@ -16,10 +16,7 @@ public struct BotRow: View {
AvatarWithStatus(bot: bot, members: model.members(of: bot), size: avatar)
VStack(alignment: .leading, spacing: lineSpacing) {
HStack(alignment: .firstTextBaseline) {
- if bot.lead {
- Image(systemName: "star.fill").font(.caption2).foregroundStyle(Palette.tertiary)
- .accessibilityLabel(L10n.tr("Lead bot"))
- } else if bot.pinned {
+ if bot.pinned && !bot.lead {
Image(systemName: "pin.fill").font(.caption2).foregroundStyle(Palette.tertiary)
}
Text(bot.name)
diff --git a/apps/ios/Kit/Sources/CodyncUI/Bots/LeadAgentAvatar.swift b/apps/ios/Kit/Sources/CodyncUI/Bots/LeadAgentAvatar.swift
new file mode 100644
index 00000000..556365e2
--- /dev/null
+++ b/apps/ios/Kit/Sources/CodyncUI/Bots/LeadAgentAvatar.swift
@@ -0,0 +1,41 @@
+import CodyncKit
+import SwiftUI
+
+struct LeadAgentAvatar: View {
+ let bot: Bot
+ @State private var showingRole = false
+
+ var body: some View {
+ CharacterAvatar(bot: bot, size: 72)
+ .overlay(alignment: .bottomTrailing) {
+ if bot.lead {
+ Button { Motion.animate { showingRole = true } } label: {
+ LeadAgentBadge(size: 28)
+ .frame(width: 44, height: 44)
+ .contentShape(Rectangle())
+ }
+ .buttonStyle(.plain)
+ .padding(-8)
+ .accessibilityLabel(L10n.tr("About the lead agent"))
+ }
+ }
+ .codyncSheet(isPresented: $showingRole) { LeadAgentInfo() }
+ }
+}
+
+private struct LeadAgentInfo: View {
+ var body: some View {
+ VStack(spacing: 0) {
+ ModalHeader("Lead agent")
+ ScrollView {
+ Text(L10n.tr("Your lead agent is your first point of contact. It follows your goals and unfinished tasks, suggests useful next steps, and coordinates work with your other bots. Its Check in routine runs twice a day by default; you can change or pause it in Routines."))
+ .font(.body)
+ .foregroundStyle(Palette.secondary)
+ .fixedSize(horizontal: false, vertical: true)
+ .frame(maxWidth: .infinity, alignment: .leading)
+ .padding(20)
+ }
+ }
+ .background(Palette.background)
+ }
+}
diff --git a/apps/ios/WhatsNew.md b/apps/ios/WhatsNew.md
index 18e57f54..99d4945a 100644
--- a/apps/ios/WhatsNew.md
+++ b/apps/ios/WhatsNew.md
@@ -16,6 +16,14 @@ a version without one gets a generic "Bug fixes and improvements" line. Delete o
- Once your computers share a network (codync-host network on each), a bot can ask a bot on another computer; the chat names that bot and its computer.
- Add Codync to ChatGPT or Claude as a connector to give your bots tasks from there; the bot's chat shows Message from Cloud assistant.
+## 2.27.1
+
+### zh-Hant
+- 主助理的頭像右下角新增金色星星;點一下詳細頁的星星,即可了解它如何追蹤目標、協調 bots 與定時關心進度。
+
+### en-US
+- Your lead agent now has a gold star on its avatar. Tap the larger star in its details to learn how it follows your goals, coordinates bots, and checks in.
+
## 2.27.0
### zh-Hant
diff --git a/docs/features/lead-bot.md b/docs/features/lead-bot.md
index 3e7987f4..2b85e004 100644
--- a/docs/features/lead-bot.md
+++ b/docs/features/lead-bot.md
@@ -15,7 +15,9 @@ to be asked. Everything about it lives in the host (`host/src/chat/lead.rs`); th
set up as on any bot: name, avatar, agent and model, folder, connectors, skills, memory, routines.
- **On top.** Every client sorts the roster in bands: the lead, then pinned bots, then the rest (by the user's order,
then recent activity). The lead can't be dragged, and moving another bot never puts it above the lead. Its row
- shows `star.fill` where a pinned bot shows its pin (TUI: `★`, with no section label above it). Its menus have no
+ shows a gold `star.fill` badge at the avatar’s bottom-right, with unread/approval badges at the top-right.
+ The larger badge in details opens the lead agent role explanation. TUI shows a gold `★` below the avatar;
+ click it or press `I` on the lead to read the same explanation, scroll with arrow keys, and close with `Esc`. Its menus have no
Pin, Hide or Delete (TUI: `p` and `x` say why).
## Initiative
diff --git a/host/src/tui/app/input.rs b/host/src/tui/app/input.rs
index 3d1c3529..60844f59 100644
--- a/host/src/tui/app/input.rs
+++ b/host/src/tui/app/input.rs
@@ -194,6 +194,7 @@ impl App {
KeyCode::Char('C') => self.open_connection(),
KeyCode::Char('F') => self.retry_failed_run(),
KeyCode::Char('I') if self.error.is_some() && self.bots.is_empty() => self.install_host(),
+ KeyCode::Char('I') if self.bot().is_some_and(|b| b.lead) => self.overlays.push(Overlay::LeadAgent(0)),
KeyCode::Char('?') => self.overlays.push(Overlay::Help(Editor::default())),
KeyCode::Char('!') => self.jump(Mark::Need),
KeyCode::Char('u') => self.jump(Mark::Unread),
@@ -394,6 +395,7 @@ impl App {
MouseEventKind::Down(MouseButton::Left) => {
let hit = self.hits.clicks.iter().rev().find(|(r, _)| r.contains(at)).map(|(_, c)| c.clone());
match hit {
+ Some(Click::LeadAgent) => self.overlays.push(Overlay::LeadAgent(0)),
Some(Click::Bot(id)) => {
self.overlays.clear();
self.select(&id);
diff --git a/host/src/tui/app/overlay_keys.rs b/host/src/tui/app/overlay_keys.rs
index d32e52e4..97c42299 100644
--- a/host/src/tui/app/overlay_keys.rs
+++ b/host/src/tui/app/overlay_keys.rs
@@ -133,6 +133,16 @@ impl App {
self.call("pairing", json!({}), After::Pairing);
Some(Overlay::Pair(PairCode::Loading))
}
+ Overlay::LeadAgent(scroll) => {
+ let (width, height) = crossterm::terminal::size().unwrap_or((80, 24));
+ let max = super::super::view::lead_agent_scroll_max(width, height);
+ match k.code {
+ KeyCode::Esc | KeyCode::Enter | KeyCode::Char('q' | 'I') => None,
+ KeyCode::Down | KeyCode::Char('j') => Some(Overlay::LeadAgent((scroll + 1).min(max))),
+ KeyCode::Up | KeyCode::Char('k') => Some(Overlay::LeadAgent(scroll.saturating_sub(1))),
+ _ => Some(Overlay::LeadAgent(scroll.min(max))),
+ }
+ }
Overlay::Usage(scroll) => {
let (_, height) = crossterm::terminal::size().unwrap_or((80, 24));
let max = super::super::view::usage_scroll_max(self, height);
diff --git a/host/src/tui/app/tests.rs b/host/src/tui/app/tests.rs
index 9feacd52..9578a9aa 100644
--- a/host/src/tui/app/tests.rs
+++ b/host/src/tui/app/tests.rs
@@ -59,3 +59,35 @@ async fn a_calls_messages_hide_behind_its_line() {
assert_eq!(shown, ["e4", "e5"], "a call's messages hide, also while it lasts (on another device); a file stays");
assert!(app.lane("b").last().is_some_and(|e| e.unfolds()), "the call's line opens its conversation");
}
+
+#[tokio::test]
+async fn lead_role_opens_from_the_keyboard_and_badge_without_changing_selection() {
+ use crossterm::event::{KeyCode, KeyEvent, KeyModifiers, MouseButton, MouseEvent, MouseEventKind};
+ use ratatui::{Terminal, backend::TestBackend};
+ let mut app = test_app();
+ for (id, lead) in [("lead", true), ("other", false)] {
+ app.bots.insert(id.into(), Bot::parse(&json!({"id": id, "name": id, "lead": lead})).expect("valid bot"));
+ }
+ app.selected = Some("other".into());
+ app.on_key(KeyEvent::from(KeyCode::Char('I')));
+ assert!(app.overlays.is_empty(), "ordinary bots have no lead explanation");
+ app.selected = Some("lead".into());
+ app.on_key(KeyEvent::from(KeyCode::Char('I')));
+ assert!(matches!(app.overlays.last(), Some(Overlay::LeadAgent(0))));
+ app.on_key(KeyEvent::from(KeyCode::Esc));
+ assert!(app.overlays.is_empty());
+ app.selected = Some("other".into());
+ let mut terminal = Terminal::new(TestBackend::new(100, 30)).expect("terminal");
+ terminal.draw(|frame| crate::tui::view::draw(frame, &mut app)).expect("draw roster");
+ let badge = app.hits.clicks.iter().find(|(_, hit)| matches!(hit, Click::LeadAgent)).expect("lead badge").0;
+ app.on_mouse(MouseEvent {
+ kind: MouseEventKind::Down(MouseButton::Left),
+ column: badge.x,
+ row: badge.y,
+ modifiers: KeyModifiers::NONE,
+ });
+ assert!(matches!(app.overlays.last(), Some(Overlay::LeadAgent(0))));
+ assert_eq!(app.selected.as_deref(), Some("other"));
+ app.on_key(KeyEvent::from(KeyCode::Enter));
+ assert!(app.overlays.is_empty());
+}
diff --git a/host/src/tui/app/ui.rs b/host/src/tui/app/ui.rs
index 8bc1784b..9c313ffd 100644
--- a/host/src/tui/app/ui.rs
+++ b/host/src/tui/app/ui.rs
@@ -296,6 +296,7 @@ pub enum PairCode {
pub enum Overlay {
Goto(Goto),
Help(Editor),
+ LeadAgent(usize),
Confirm(Confirm),
NewBot(NewBot),
Folder(FolderPicker),
@@ -325,6 +326,7 @@ pub struct Toast {
#[derive(Clone)]
pub enum Click {
+ LeadAgent,
Bot(String),
Option {
entry: String,
diff --git a/host/src/tui/view/help.rs b/host/src/tui/view/help.rs
index 21debe45..1428f1a1 100644
--- a/host/src/tui/view/help.rs
+++ b/host/src/tui/view/help.rs
@@ -10,7 +10,7 @@ use super::buffer::{centered, frame_box, put, u};
use super::overlay::field_line;
use super::style::theme;
-const HELP: [(&str, &str, &str); 67] = [
+const HELP: [(&str, &str, &str); 68] = [
("MOVE", "j k ↑ ↓", "next / previous bot"),
("MOVE", "[ ]", "previous / next bot"),
("MOVE", "1…9", "jump to bot 1–9"),
@@ -55,6 +55,7 @@ const HELP: [(&str, &str, &str); 67] = [
("BOTS", "n", "new bot"),
("BOTS", "m", "new group chat"),
("BOTS", "e", "settings, or edit a group"),
+ ("BOTS", "I", "About the lead agent"),
("BOTS", "p", "pin / unpin"),
("BOTS", "J K", "move bot down / up"),
("BOTS", "S", "new session"),
diff --git a/host/src/tui/view/lead_agent.rs b/host/src/tui/view/lead_agent.rs
new file mode 100644
index 00000000..4f804eda
--- /dev/null
+++ b/host/src/tui/view/lead_agent.rs
@@ -0,0 +1,35 @@
+//! The lead badge's role explanation, also available with I on the lead bot.
+use ratatui::buffer::Buffer;
+use ratatui::layout::Rect;
+use ratatui::text::{Line, Span};
+
+use super::super::{l10n::tr, md};
+use super::buffer::{centered, frame_box, put, put_line};
+use super::style::theme;
+
+const DESCRIPTION: &str = "Your lead agent is your first point of contact. It follows your goals and unfinished tasks, suggests useful next steps, and coordinates work with your other bots. Its Check in routine runs twice a day by default; you can change or pause it in Routines.";
+
+fn lines(width: u16) -> Vec<Line<'static>> {
+ md::wrap(&[Span::styled(tr(DESCRIPTION).into_owned(), theme().text)], usize::from(width), &[], &[])
+}
+
+pub(in crate::tui) fn lead_agent_scroll_max(width: u16, height: u16) -> usize {
+ let r = centered(Rect::new(0, 0, width, height), 62, 16);
+ lines(r.width.saturating_sub(4)).len().saturating_sub(usize::from(r.height.saturating_sub(4)))
+}
+
+pub(super) fn lead_agent(buf: &mut Buffer, area: Rect, scroll: usize) {
+ let t = theme();
+ let r = centered(area, 62, 16);
+ let inner = frame_box(buf, r, t.amber, t.panel, Some((tr("Lead agent").as_ref(), t.amber)));
+ if inner.height < 2 || inner.width == 0 {
+ return;
+ }
+ let content = lines(inner.width);
+ let visible = usize::from(inner.height - 2);
+ let start = scroll.min(content.len().saturating_sub(visible));
+ for (offset, line) in content.iter().skip(start).take(visible).enumerate() {
+ put_line(buf, inner.x, inner.y + super::buffer::u(offset), inner.width, line);
+ }
+ put(buf, inner.x, inner.bottom() - 1, inner.width, tr("↑↓ scroll · esc close").as_ref(), t.dim);
+}
diff --git a/host/src/tui/view/mod.rs b/host/src/tui/view/mod.rs
index e3e45f09..63dfd2d7 100644
--- a/host/src/tui/view/mod.rs
+++ b/host/src/tui/view/mod.rs
@@ -16,6 +16,7 @@ mod fallbacks;
mod forms;
mod goto;
mod help;
+mod lead_agent;
mod new_bot;
mod overlay;
mod pair;
@@ -31,6 +32,7 @@ mod usage;
pub(super) use buffer::{centered, frame_box, hline, put, restyle, rput, u};
pub(super) use chat::composer_lines;
pub(super) use fallbacks::{chain_line, using_line};
+pub(super) use lead_agent::lead_agent_scroll_max;
pub(super) use overlay::{field_line, input_line};
pub(super) use style::theme;
pub(super) use time::when;
diff --git a/host/src/tui/view/overlay.rs b/host/src/tui/view/overlay.rs
index 52acd2b6..257e60c7 100644
--- a/host/src/tui/view/overlay.rs
+++ b/host/src/tui/view/overlay.rs
@@ -40,6 +40,7 @@ pub(super) fn overlay(buf: &mut Buffer, area: Rect, app: &mut App, top: &Overlay
goto(buf, area, app, g, &items);
}
Overlay::Help(filter) => help(buf, area, filter),
+ Overlay::LeadAgent(scroll) => super::lead_agent::lead_agent(buf, area, *scroll),
Overlay::Confirm(c) => {
let t = theme();
let r = centered(area, 62, 8);
diff --git a/host/src/tui/view/roster.rs b/host/src/tui/view/roster.rs
index c395cb9a..d8e29378 100644
--- a/host/src/tui/view/roster.rs
+++ b/host/src/tui/view/roster.rs
@@ -92,8 +92,12 @@ pub(super) fn roster(buf: &mut Buffer, r: Rect, app: &mut App, narrow: bool) {
let tx = rput(buf, r.right() - 1, yy, &time, if b.unread > 0 { t.bold } else { t.dim });
let gx = tx.saturating_sub(2);
put(buf, gx, yy, 1, g, gs);
- // The lead's star, where the apps show it.
- let name_x = if b.lead { put(buf, x0 + 5, yy, 2, "★", t.dim) + 1 } else { x0 + 5 };
+ // The badge sits below the avatar, leaving activity and unread indicators visible.
+ if b.lead {
+ put(buf, x0 + 3, yy + 1, 1, "★", t.amber);
+ app.hits.clicks.push((Rect::new(x0 + 3, yy + 1, 1, 1), Click::LeadAgent));
+ }
+ let name_x = x0 + 5;
put(buf, name_x, yy, gx.saturating_sub(name_x + 1), &b.name, t.bold);
let (pv, ps) = preview(b);
let badge = if b.unread > 0 { format!(" {} ", b.unread) } else { String::new() };
@@ -169,5 +173,9 @@ pub(super) fn compact_roster(buf: &mut Buffer, r: Rect, app: &mut App) {
put_line(buf, r.x + 1, y, 2, &avatar(app, b));
let (g, gs) = glyph(app, b.mark());
put(buf, r.x + 3, y, 1, g, gs);
+ if b.lead && y + 1 < r.bottom() {
+ put(buf, r.x + 2, y + 1, 1, "★", t.amber);
+ app.hits.clicks.push((Rect::new(r.x + 2, y + 1, 1, 1), Click::LeadAgent));
+ }
}
}
diff --git a/web/content/docs/bots.mdx b/web/content/docs/bots.mdx
index 64b921b9..7ac23141 100644
--- a/web/content/docs/bots.mdx
+++ b/web/content/docs/bots.mdx
@@ -4,7 +4,7 @@ You can make as many bots as you like, and they work at the same time. A reviewe
## Your lead bot
-Every computer comes with one bot of its own, named **Codync** until you rename it: your lead bot. It sits at the top of the list with a star, and it's the one to talk to first.
+Every computer comes with one bot of its own, named **Codync** until you rename it: your lead bot. It sits at the top of the list with a gold star at the bottom-right of its avatar, and it's the one to talk to first. Open its details and tap or click the larger star to read what your **Lead agent** does. In the terminal, click its gold star or select the lead bot and press `I`; use the arrow keys to scroll and `Esc` to close.
- **It takes initiative.** It keeps track of what you're working toward, follows up on what's still open and offers the next step. When it could help more with access to one of your services, such as Gmail or your calendar, it says what for and asks you to connect it, with a card in the chat.
- **It checks in.** Its routine **Check in** runs at 9:00 and 18:00 on your computer's clock. If something deserves your attention, or there's a step it can take for you, it messages you; otherwise it stays quiet. What it reads in your email, documents or web pages is information to it, never instructions, and it doesn't send, forward, reply to, delete, pay for or post anything you didn't ask for in the chat. It skips a check-in while your agent plan is above 75% of a limit. Change the times, pause it or delete it like any routine. See [Routines](/docs/routines).