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): explain the memory Hermes Agent and Gemini CLI bots share

leepokai0da4eafb867b
diff --git a/apps/desktop/src/renderer/views/bots/MemoryInfoSheet.tsx b/apps/desktop/src/renderer/views/bots/MemoryInfoSheet.tsx
index 880efd80..4499f1ac 100644
--- a/apps/desktop/src/renderer/views/bots/MemoryInfoSheet.tsx
+++ b/apps/desktop/src/renderer/views/bots/MemoryInfoSheet.tsx
@@ -7,14 +7,22 @@ import { useTr } from '../../lib/use-language'
interface Point { icon: string; title: string; detail: string }
-/** What the harness's own memory switch means. `readable`: Codync shows its notes (Claude Code's are a file). The harness name is filled in after the sentence is translated. */
-export function harnessInfo(harness: string, readable: boolean, tr: (text: string) => string): Point[] {
+/** How the bot reaches its harness's own memory: a switch with its notes shown here (Claude Code's are a file), a switch only, or one memory every bot on the harness shares, with no switch (Hermes Agent, Gemini CLI). */
+type HarnessAccess = 'readable' | 'hidden' | 'shared'
+
+/** What the harness's own memory means for the bot. The harness name is filled in after the sentence is translated. */
+export function harnessInfo(harness: string, access: HarnessAccess, tr: (text: string) => string): Point[] {
const fill = (template: string) => tr(template).replaceAll('{name}', harness)
+ const shared = access === 'shared'
return [
- { icon: 'brain', title: tr('A memory of its own'), detail: fill("{name} keeps notes apart from Codync's memory. It's off by default, so this bot has one memory and you see all of it here.") },
+ { icon: 'brain', title: tr('A memory of its own'), detail: fill(shared
+ ? "{name} keeps notes apart from Codync's memory, and Codync can't turn them off for one bot."
+ : "{name} keeps notes apart from Codync's memory. It's off by default, so this bot has one memory and you see all of it here.") },
+ ...(shared ? [{ icon: 'person.2', title: tr('Shared by every bot'), detail: fill('Every bot that runs {name} reads and writes the same notes, and so does {name} when you use it outside Codync.') }] : []),
{ icon: 'square.on.square', title: tr('Remembered twice'), detail: tr('With both on, the bot may save the same thing twice, and the two can disagree after something changes.') },
{ icon: 'trash', title: tr('Forgetting'), detail: fill("What the bot forgets in Codync stays in {name}'s notes. Codync can't change them.") },
- { icon: 'eye', title: tr('Where to see it'), detail: fill(readable ? 'Its notes show read-only under the {name} tab.' : "Codync can't show it; look in {name} itself.") },
+ { icon: 'eye', title: tr('Where to see it'), detail: fill(access === 'readable' ? 'Its notes show read-only under the {name} tab.' : "Codync can't show it; look in {name} itself.") },
+ ...(shared ? [{ icon: 'gearshape', title: tr('Turning it off'), detail: fill("Where {name} has a setting for it, that setting turns it off for every session at once.") }] : []),
]
}
diff --git a/apps/desktop/src/renderer/views/bots/MemoryView.tsx b/apps/desktop/src/renderer/views/bots/MemoryView.tsx
index 58854756..3112fce8 100644
--- a/apps/desktop/src/renderer/views/bots/MemoryView.tsx
+++ b/apps/desktop/src/renderer/views/bots/MemoryView.tsx
@@ -36,6 +36,7 @@ export function MemoryCard({ botId }: { botId: string }) {
// Claude Code's section goes when its memory is turned off (on another device too).
useEffect(() => { if (section === 'harness' && view && !view.projectMemory) setSection('bot') }, [section, view])
const harness = host.backendName(bot?.backend ?? 'claude')
+ const own = tr("{name}'s own memory").replaceAll('{name}', harness)
const sections: { id: Section; label: string }[] = [
{ id: 'yours', label: 'About you' }, { id: 'bot', label: 'This bot' }, { id: 'dreams', label: 'Dreams' },
...(view?.projectMemory ? [{ id: 'harness' as const, label: harness }] : []),
@@ -55,10 +56,13 @@ export function MemoryCard({ botId }: { botId: string }) {
{view && bot && section === 'yours' && <Switch on={bot.sharedMemory} onChange={(on) => host.setSharedMemory(bot, on)}>
Use what your bots share
</Switch>}
- {view && bot && section === 'bot' && bot.harnessMemory !== null && <HStack gap={4}>
- <span>{tr("{name}'s own memory").replaceAll('{name}', harness)}</span>
+ {/* The harness's own memory: a switch where Codync can turn it off, "Shared" where every bot on it shares it. */}
+ {view && bot && section === 'bot' && (bot.harnessMemory !== null || bot.harnessMemoryShared) && <HStack gap={4}>
+ <span>{own}</span>
<IconButton title={tr("About {name}'s own memory").replaceAll('{name}', harness)} icon="info.circle" onClick={() => setInfo('harness')} />
- <Switch on={bot.harnessMemory} onChange={(on) => host.setHarnessMemory(bot, on)} label={tr("{name}'s own memory").replaceAll('{name}', harness)} className="memory-harness-switch" />
+ {bot.harnessMemory !== null
+ ? <Switch on={bot.harnessMemory} onChange={(on) => host.setHarnessMemory(bot, on)} label={own} className="memory-harness-switch" />
+ : <Text tone="secondary" className="memory-harness-shared">{tr('Shared')}</Text>}
</HStack>}
{layer && [
<p key="note" className="memory-muted">{tr(section === 'yours'
@@ -98,7 +102,8 @@ export function MemoryCard({ botId }: { botId: string }) {
{file && <MemoryFileSheet memory={memory} target={file} />}
</Sheet>
<FormSheet open={info !== null} onClose={() => setInfo(null)} height={560}>
- {info === 'harness' && <MemoryInfoSheet icon="brain" title={tr("{name}'s own memory").replaceAll('{name}', harness)} points={harnessInfo(harness, bot?.backend === 'claude', tr)} />}
+ {info === 'harness' && <MemoryInfoSheet icon="brain" title={own}
+ points={harnessInfo(harness, bot?.harnessMemoryShared ? 'shared' : bot?.backend === 'claude' ? 'readable' : 'hidden', tr)} />}
{info === 'dreams' && <MemoryInfoSheet icon="moon" title="Dreaming" points={dreamsInfo} />}
</FormSheet>
</>
diff --git a/apps/desktop/src/renderer/views/bots/memory.css b/apps/desktop/src/renderer/views/bots/memory.css
index 3a1b8d0b..8c18c0c1 100644
--- a/apps/desktop/src/renderer/views/bots/memory.css
+++ b/apps/desktop/src/renderer/views/bots/memory.css
@@ -21,3 +21,4 @@
.memory-file-text { margin: 0; white-space: pre-wrap; overflow-wrap: anywhere; user-select: text; font: var(--text-callout)/1.5 var(--mono); }
.memory-info-icon { padding-top: 2px; }
.switch.memory-harness-switch { flex: 1; justify-content: flex-end; }
+.memory-harness-shared { flex: 1; text-align: end; }
diff --git a/apps/desktop/src/shared/models.ts b/apps/desktop/src/shared/models.ts
index f2f4e691..8a8540f7 100644
--- a/apps/desktop/src/shared/models.ts
+++ b/apps/desktop/src/shared/models.ts
@@ -53,6 +53,8 @@ export interface Bot {
sharedMemory: boolean
/** Keeps the harness's own memory (Claude Code's…) on beside Codync's; null where it has no switch. */
harnessMemory: boolean | null
+ /** The harness keeps one memory for all its sessions that Codync can't turn off (Hermes Agent, Gemini CLI): every bot on it shares it. */
+ harnessMemoryShared: boolean
/** Moves whenever memory changes, so an open memory screen fetches it again. */
memoryRev: number
autoName: boolean
@@ -103,6 +105,7 @@ export function normalizeBot(raw: Partial<Bot> & { id: string }): Bot {
createdBy: raw.createdBy ?? null,
sharedMemory: raw.sharedMemory ?? raw.managedWorkspace ?? false,
harnessMemory: raw.harnessMemory ?? null,
+ harnessMemoryShared: raw.harnessMemoryShared ?? false,
memoryRev: raw.memoryRev ?? 0,
autoName: raw.autoName ?? false,
createdAt,
diff --git a/apps/ios/Kit/Sources/CodyncKit/Models/Models.swift b/apps/ios/Kit/Sources/CodyncKit/Models/Models.swift
index b25a1095..2d9e280e 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Models/Models.swift
+++ b/apps/ios/Kit/Sources/CodyncKit/Models/Models.swift
@@ -51,6 +51,9 @@ public struct Bot: Codable, Identifiable, Hashable, Sendable {
public var sharedMemory: Bool?
/// Keeps the harness's own memory (Claude Code's…) on beside Codync's. Nil where it has no switch.
public var harnessMemory: Bool?
+ /// The harness keeps one memory for all its sessions that Codync can't turn off (Hermes Agent, Gemini CLI):
+ /// every bot on it shares it. Nil from an older host.
+ public var harnessMemoryShared: Bool?
/// Moves whenever memory changes, so an open memory screen fetches it again.
public var memoryRev: Int64?
/// Created without a name: the host names it after its first few conversations.
@@ -476,6 +479,7 @@ extension Bot {
createdBy = try c.decodeIfPresent(String.self, forKey: .createdBy)
sharedMemory = try c.decodeIfPresent(Bool.self, forKey: .sharedMemory)
harnessMemory = try c.decodeIfPresent(Bool.self, forKey: .harnessMemory)
+ harnessMemoryShared = try c.decodeIfPresent(Bool.self, forKey: .harnessMemoryShared)
memoryRev = try c.decodeIfPresent(Int64.self, forKey: .memoryRev)
autoName = try c.decodeIfPresent(Bool.self, forKey: .autoName) ?? false
createdAt = try c.decodeIfPresent(Int64.self, forKey: .createdAt) ?? 0
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/de.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/de.json
index a46515d7..e7ca89ed 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/de.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/de.json
@@ -828,6 +828,13 @@
"Dreaming": "Gedächtnispflege",
"{name}'s own memory": "Eigenes Gedächtnis von {name}",
"About {name}'s own memory": "Über das eigene Gedächtnis von {name}",
+ "Shared": "Geteilt",
+ "{name} keeps notes apart from Codync's memory, and Codync can't turn them off for one bot.": "{name} führt Notizen getrennt von Codyncs Gedächtnis, und Codync kann sie nicht für einen einzelnen Bot ausschalten.",
+ "Shared by every bot": "Von allen Bots geteilt",
+ "Every bot that runs {name} reads and writes the same notes, and so does {name} when you use it outside Codync.": "Jeder Bot mit {name} liest und schreibt dieselben Notizen, und {name} selbst auch, wenn du es außerhalb von Codync nutzt.",
+ "Turning it off": "Ausschalten",
+ "Where {name} has a setting for it, that setting turns it off for every session at once.": "Wo {name} eine Einstellung dafür hat, schaltet sie es für alle Sitzungen auf einmal aus.",
+ "What this bot learned about you · {harness}'s own memory: shared by every {harness} bot": "Was dieser Bot über dich gelernt hat · Eigenes Gedächtnis von {harness}: von allen {harness}-Bots geteilt",
"Turn on {name}'s own memory?": "Eigenes Gedächtnis von {name} einschalten?",
"Tidying between chats": "Aufräumen zwischen Chats",
"Adds and takes out": "Hinzufügen und Entfernen",
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/es.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/es.json
index 210c5131..5f372272 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/es.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/es.json
@@ -828,6 +828,13 @@
"Dreaming": "Consolidando memoria",
"{name}'s own memory": "Memoria propia de {name}",
"About {name}'s own memory": "Acerca de la memoria propia de {name}",
+ "Shared": "Compartida",
+ "{name} keeps notes apart from Codync's memory, and Codync can't turn them off for one bot.": "{name} guarda notas aparte de la memoria de Codync, y Codync no puede desactivarlas para un solo bot.",
+ "Shared by every bot": "Compartida por todos los bots",
+ "Every bot that runs {name} reads and writes the same notes, and so does {name} when you use it outside Codync.": "Cada bot que usa {name} lee y escribe las mismas notas, y también {name} cuando lo usas fuera de Codync.",
+ "Turning it off": "Desactivarla",
+ "Where {name} has a setting for it, that setting turns it off for every session at once.": "Si {name} tiene un ajuste para ello, ese ajuste la desactiva para todas las sesiones a la vez.",
+ "What this bot learned about you · {harness}'s own memory: shared by every {harness} bot": "Lo que este bot aprendió de ti · Memoria propia de {harness}: compartida por todos los bots de {harness}",
"Turn on {name}'s own memory?": "¿Activar la memoria propia de {name}?",
"Tidying between chats": "Organizar entre chats",
"Adds and takes out": "Añade y elimina",
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/fr.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/fr.json
index ea453740..2286cf22 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/fr.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/fr.json
@@ -828,6 +828,13 @@
"Dreaming": "Consolidation",
"{name}'s own memory": "Mémoire propre à {name}",
"About {name}'s own memory": "À propos de la mémoire de {name}",
+ "Shared": "Partagée",
+ "{name} keeps notes apart from Codync's memory, and Codync can't turn them off for one bot.": "{name} garde des notes à part de la mémoire de Codync, et Codync ne peut pas les désactiver pour un seul bot.",
+ "Shared by every bot": "Partagée par tous les bots",
+ "Every bot that runs {name} reads and writes the same notes, and so does {name} when you use it outside Codync.": "Chaque bot qui utilise {name} lit et écrit les mêmes notes, tout comme {name} quand vous l'utilisez hors de Codync.",
+ "Turning it off": "La désactiver",
+ "Where {name} has a setting for it, that setting turns it off for every session at once.": "Si {name} a un réglage pour cela, ce réglage la désactive pour toutes les sessions à la fois.",
+ "What this bot learned about you · {harness}'s own memory: shared by every {harness} bot": "Ce que ce bot a appris sur vous · Mémoire de {harness} : partagée par tous les bots {harness}",
"Turn on {name}'s own memory?": "Activer la mémoire propre à {name} ?",
"Tidying between chats": "Rangement entre les discussions",
"Adds and takes out": "Ajouts et suppressions",
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ja.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ja.json
index 54fb8b73..35429dca 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ja.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ja.json
@@ -828,6 +828,13 @@
"Dreaming": "記憶の整理",
"{name}'s own memory": "{name}自身の記憶",
"About {name}'s own memory": "{name}独自の記憶について",
+ "Shared": "共有",
+ "{name} keeps notes apart from Codync's memory, and Codync can't turn them off for one bot.": "{name} は Codync の記憶とは別にメモを残します。Codync はボットごとにオフにできません。",
+ "Shared by every bot": "すべてのボットで共有",
+ "Every bot that runs {name} reads and writes the same notes, and so does {name} when you use it outside Codync.": "{name} を使うボットはすべて同じメモを読み書きします。Codync の外で {name} を使うときも同じです。",
+ "Turning it off": "オフにするには",
+ "Where {name} has a setting for it, that setting turns it off for every session at once.": "{name} に設定がある場合は、その設定ですべてのセッションで一度にオフになります。",
+ "What this bot learned about you · {harness}'s own memory: shared by every {harness} bot": "このボットがあなたについて学んだこと · {harness}独自の記憶:{harness} のすべてのボットで共有",
"Turn on {name}'s own memory?": "{name} 自身のメモリをオンにしますか?",
"Tidying between chats": "チャットの合間に整理整頓",
"Adds and takes out": "追加と削除",
diff --git a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ko.json b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ko.json
index eb2c6e4f..9de6601f 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ko.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/ko.json
@@ -828,6 +828,13 @@
"Dreaming": "기억 정리",
"{name}'s own memory": "{name} 자체 기억",
"About {name}'s own memory": "{name} 자체 기억 정보",
+ "Shared": "공유",
+ "{name} keeps notes apart from Codync's memory, and Codync can't turn them off for one bot.": "{name}은(는) Codync 기억과 별도로 메모를 남기며, Codync는 봇 하나에 대해서만 끌 수 없습니다.",
+ "Shared by every bot": "모든 봇이 공유",
+ "Every bot that runs {name} reads and writes the same notes, and so does {name} when you use it outside Codync.": "{name}을(를) 쓰는 모든 봇이 같은 메모를 읽고 쓰며, Codync 밖에서 {name}을(를) 쓸 때도 마찬가지입니다.",
+ "Turning it off": "끄는 방법",
+ "Where {name} has a setting for it, that setting turns it off for every session at once.": "{name}에 관련 설정이 있으면, 그 설정으로 모든 세션에서 한 번에 꺼집니다.",
+ "What this bot learned about you · {harness}'s own memory: shared by every {harness} bot": "이 봇이 알게 된 나에 관한 정보 · {harness} 자체 기억: 모든 {harness} 봇이 공유",
"Turn on {name}'s own memory?": "{name} 자체 기억을 켤까요?",
"Tidying between chats": "채팅 사이 정리",
"Adds and takes out": "추가 및 삭제",
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 149108e2..aeeef54a 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hans.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hans.json
@@ -828,6 +828,13 @@
"Dreaming": "梦境",
"{name}'s own memory": "{name} 自己的记忆",
"About {name}'s own memory": "关于 {name} 自己的记忆",
+ "Shared": "共用",
+ "{name} keeps notes apart from Codync's memory, and Codync can't turn them off for one bot.": "{name} 会在 Codync 的记忆之外另外记笔记,Codync 没办法只为一个 Bot 关掉。",
+ "Shared by every bot": "所有 Bot 共用",
+ "Every bot that runs {name} reads and writes the same notes, and so does {name} when you use it outside Codync.": "每个使用 {name} 的 Bot 都读写同一份笔记,你在 Codync 之外使用 {name} 时也一样。",
+ "Turning it off": "关掉它",
+ "Where {name} has a setting for it, that setting turns it off for every session at once.": "如果 {name} 有相关设置,用它关掉会一次应用到所有会话。",
+ "What this bot learned about you · {harness}'s own memory: shared by every {harness} bot": "这个 Bot 了解到的关于你的事 · {harness} 自己的记忆:所有 {harness} Bot 共用",
"Turn on {name}'s own memory?": "打开 {name} 自己的记忆?",
"Tidying between chats": "对话之间整理",
"Adds and takes out": "添加和删去",
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 e957d9de..a3e4c5e4 100644
--- a/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hant.json
+++ b/apps/ios/Kit/Sources/CodyncKit/Resources/Languages/zh-Hant.json
@@ -828,6 +828,13 @@
"Dreaming": "夢境",
"{name}'s own memory": "{name} 自己的記憶",
"About {name}'s own memory": "關於 {name} 自己的記憶",
+ "Shared": "共用",
+ "{name} keeps notes apart from Codync's memory, and Codync can't turn them off for one bot.": "{name} 會在 Codync 的記憶之外另外記筆記,Codync 沒辦法只為一個 Bot 關掉。",
+ "Shared by every bot": "所有 Bot 共用",
+ "Every bot that runs {name} reads and writes the same notes, and so does {name} when you use it outside Codync.": "每個使用 {name} 的 Bot 都讀寫同一份筆記,你在 Codync 之外使用 {name} 時也一樣。",
+ "Turning it off": "關掉它",
+ "Where {name} has a setting for it, that setting turns it off for every session at once.": "如果 {name} 有相關設定,用它關掉會一次套用到所有會話。",
+ "What this bot learned about you · {harness}'s own memory: shared by every {harness} bot": "這個 Bot 瞭解到的關於你的事 · {harness} 自己的記憶:所有 {harness} Bot 共用",
"Turn on {name}'s own memory?": "開啟 {name} 自己的記憶?",
"Tidying between chats": "對話之間整理",
"Adds and takes out": "新增和刪去",
diff --git a/apps/ios/Kit/Sources/CodyncUI/Bots/MemoryInfoSheet.swift b/apps/ios/Kit/Sources/CodyncUI/Bots/MemoryInfoSheet.swift
index d8d77e77..71462fe7 100644
--- a/apps/ios/Kit/Sources/CodyncUI/Bots/MemoryInfoSheet.swift
+++ b/apps/ios/Kit/Sources/CodyncUI/Bots/MemoryInfoSheet.swift
@@ -1,7 +1,7 @@
import CodyncKit
import SwiftUI
-/// The memory screen's info buttons: what the harness's own memory switch means, and what dreaming does. The same
+/// The memory screen's info buttons: what the harness's own memory means for the bot, and what dreaming does. The same
/// text as the desktop app's; the terminal UI says it short in place.
struct MemoryInfoSheet: View {
struct Point {
@@ -13,18 +13,33 @@ struct MemoryInfoSheet: View {
let title: String
let points: [Point]
- /// `readable`: Codync can show the harness's notes (Claude Code's are a file on the computer).
- static func harness(_ harness: String, readable: Bool) -> MemoryInfoSheet {
+ /// How the bot reaches its harness's own memory.
+ enum Access {
+ /// A switch, and Codync shows the notes (Claude Code's are a file on the computer).
+ case readable
+ /// A switch only.
+ case hidden
+ /// No switch: one memory every bot on the harness shares (Hermes Agent, Gemini CLI).
+ case shared
+ }
+
+ static func harness(_ harness: String, access: Access) -> MemoryInfoSheet {
// Translate the sentence, then put the harness name in, so the name stays as written.
func fill(_ template: String) -> String {
L10n.tr(template).replacingOccurrences(of: "{name}", with: harness)
}
- return MemoryInfoSheet(title: fill("{name}'s own memory"), points: [
- Point(icon: "brain", title: "A memory of its own", detail: fill("{name} keeps notes apart from Codync's memory. It's off by default, so this bot has one memory and you see all of it here.")),
+ let shared = access == .shared
+ let points: [Point?] = [
+ Point(icon: "brain", title: "A memory of its own", detail: fill(shared
+ ? "{name} keeps notes apart from Codync's memory, and Codync can't turn them off for one bot."
+ : "{name} keeps notes apart from Codync's memory. It's off by default, so this bot has one memory and you see all of it here.")),
+ shared ? Point(icon: "person.2", title: "Shared by every bot", detail: fill("Every bot that runs {name} reads and writes the same notes, and so does {name} when you use it outside Codync.")) : nil,
Point(icon: "square.on.square", title: "Remembered twice", detail: "With both on, the bot may save the same thing twice, and the two can disagree after something changes."),
Point(icon: "trash", title: "Forgetting", detail: fill("What the bot forgets in Codync stays in {name}'s notes. Codync can't change them.")),
- Point(icon: "eye", title: "Where to see it", detail: fill(readable ? "Its notes show read-only under the {name} tab." : "Codync can't show it; look in {name} itself.")),
- ])
+ Point(icon: "eye", title: "Where to see it", detail: fill(access == .readable ? "Its notes show read-only under the {name} tab." : "Codync can't show it; look in {name} itself.")),
+ shared ? Point(icon: "gearshape", title: "Turning it off", detail: fill("Where {name} has a setting for it, that setting turns it off for every session at once.")) : nil,
+ ]
+ return MemoryInfoSheet(title: fill("{name}'s own memory"), points: points.compactMap { $0 })
}
static let dreams = MemoryInfoSheet(title: "Dreaming", points: [
diff --git a/apps/ios/Kit/Sources/CodyncUI/Bots/MemoryView.swift b/apps/ios/Kit/Sources/CodyncUI/Bots/MemoryView.swift
index 77b002a5..2dc31d8a 100644
--- a/apps/ios/Kit/Sources/CodyncUI/Bots/MemoryView.swift
+++ b/apps/ios/Kit/Sources/CodyncUI/Bots/MemoryView.swift
@@ -55,7 +55,11 @@ struct MemoryCard: View {
}
.codyncSheet(item: $info) { info in
switch info {
- case .harness: if let bot { MemoryInfoSheet.harness(host.backendName(bot.backend), readable: bot.backend == "claude") }
+ case .harness:
+ if let bot {
+ MemoryInfoSheet.harness(host.backendName(bot.backend), access: bot.harnessMemoryShared == true
+ ? .shared : bot.backend == "claude" ? .readable : .hidden)
+ }
case .dreams: MemoryInfoSheet.dreams
}
}
@@ -88,7 +92,8 @@ struct MemoryCard: View {
}
.toggleStyle(.codync)
}
- if !shared, let bot, let on = bot.harnessMemory {
+ // The harness's own memory: a switch where Codync can turn it off, "Shared" where every bot on it shares it.
+ if !shared, let bot, bot.harnessMemory != nil || bot.harnessMemoryShared == true {
let name = host.backendName(bot.backend)
let own = L10n.tr("{name}'s own memory").replacingOccurrences(of: "{name}", with: name)
HStack(spacing: 4) {
@@ -96,9 +101,14 @@ struct MemoryCard: View {
IconButton(L10n.tr("About {name}'s own memory").replacingOccurrences(of: "{name}", with: name), systemImage: "info.circle") {
withAnimation(Motion.layout) { info = .harness }
}
- Toggle(isOn: Binding(get: { on }, set: { host.setHarnessMemory(bot, $0) })) { EmptyView() }
- .toggleStyle(.codync)
- .accessibilityLabel(own)
+ if let on = bot.harnessMemory {
+ Toggle(isOn: Binding(get: { on }, set: { host.setHarnessMemory(bot, $0) })) { EmptyView() }
+ .toggleStyle(.codync)
+ .accessibilityLabel(own)
+ } else {
+ Spacer(minLength: 8)
+ Text(L10n.tr("Shared")).foregroundStyle(Palette.secondary).lineLimit(1)
+ }
}
}
Text(L10n.tr(shared
diff --git a/apps/ios/WhatsNew.md b/apps/ios/WhatsNew.md
index b37026a2..d4fb3e8e 100644
--- a/apps/ios/WhatsNew.md
+++ b/apps/ios/WhatsNew.md
@@ -14,6 +14,7 @@ a version without one gets a generic "Bug fixes and improvements" line. Delete o
- 鎖定畫面的即時動態加上進度條,四格依任務進度填滿,顏色跟著狀態走。
- 帳號選單裡的「電腦與設定」和它打開的頁面同名。
- 新增聯結器失敗後再試一次,會使用你改好的金鑰。
+- 使用 Hermes Agent 或 Gemini CLI 的 Bot,記憶頁會說明它們自己的記憶由所有用同一個 agent 的 Bot 共用,Codync 沒辦法關掉。
### en-US
- Create bots that run Hermes Agent.
@@ -21,6 +22,7 @@ a version without one gets a generic "Bug fixes and improvements" line. Delete o
- Live Activities on the Lock Screen show a progress line that fills as the task moves, in the state's color.
- The account sheet's Computers & settings row now has the same name as the page it opens.
- Trying again after adding a connector failed uses the key you corrected.
+- For bots that run Hermes Agent or Gemini CLI, Memory explains that the agent's own memory is shared by every bot that runs it and Codync can't turn it off.
## 2.24.0
diff --git a/docs/design/bot-memory.md b/docs/design/bot-memory.md
index 85e04fec..f54a7111 100644
--- a/docs/design/bot-memory.md
+++ b/docs/design/bot-memory.md
@@ -533,6 +533,7 @@ build.
read-only since 2.21.0 (the owner's call: the user changes memory by telling the bot).
- **The dream log** (added green, archived red) with an info button saying what dreaming does.
- **The harness's own memory switch** in the bot's section, off by default, with an info button; kept on, Claude Code's `MEMORY.md` shows read-only.
+- **"Shared" in place of the switch**, with an info button, where the harness keeps one memory every bot on it shares and Codync can't turn off (Gemini CLI, Hermes Agent: `harnessMemoryShared`).
- **Notes** under each layer's facts: name, description, size and date, an over-cap mark, and a view to read one.
- **In the chat**, only an editable handoff draft at rollover, folding to one line once sent; compactions and a
kept handoff leave no line (2026-10-18, at the owner's request).
diff --git a/docs/features/context-and-memory.md b/docs/features/context-and-memory.md
index 2f4e0b4c..7c9c2b2a 100644
--- a/docs/features/context-and-memory.md
+++ b/docs/features/context-and-memory.md
@@ -128,6 +128,14 @@ Claude Code's own memory; the rules live in the `codync-mem` crate, and `chat/me
harness runs its memory as it sets it, and Claude Code's `MEMORY.md` shows read-only in a "Claude Code" section
(empty until it saves something). An edit to another harness turns the switch off. Using the harness's memory
instead of Codync's is planned: [harness memory](../plans/harness-memory.md).
+- **Shared by every bot.** Gemini CLI (`~/.gemini/GEMINI.md`) and Hermes Agent (`~/.hermes/memories`) keep one
+ memory for all their sessions that Codync can't turn off (`own_memory::shared`, bot field `harnessMemoryShared`).
+ In place of the switch, "This bot" shows "<harness>'s own memory · Shared" with an info button (the host doesn't
+ read whether the user turned it off in the harness's settings, so the row names no state): every bot on that
+ harness reads and writes the same notes, and so does the harness outside Codync; forgetting in Codync doesn't reach
+ them, Codync can't show them, and a harness setting, where there is one (Hermes Agent's `memory.*` flags; Gemini CLI has none), turns them off for every session at once.
+ The terminal UI says it in the section's note. Kilo Code and Kiro aren't marked: how far their memory is shared
+ isn't confirmed.
- **The apps** (iPhone, desktop, terminal) show "About you", "This bot", the dream log and Claude Code's notes,
read-only: the user changes memory by telling the bot in the chat. Each layer shows its `MEMORY.md` facts with
who wrote them (the `memory` method keeps the shape of the earlier entries: one per fact, `state` active), then
diff --git a/docs/plans/android-app.md b/docs/plans/android-app.md
index 0df82f7a..b9a0f0e4 100644
--- a/docs/plans/android-app.md
+++ b/docs/plans/android-app.md
@@ -51,7 +51,7 @@ was walked through on an emulator against a real host.
memory screen still calls the removed `memoryDetail`, `reviewMemory`, `exportMemory` and `importMemory`
(`MemoryModel.kt`, `MemoryCard.kt`, `LiveMemoryTest.kt`), so it shows an error. Missing too: the two layers
(yours and the bot's) with each `MEMORY.md` line and who wrote it, memory notes, the dream log with its info
- sheet, the harness's own memory switch with its info sheet (2.19.0) and the handoff card. Since 2.21.0 the memory screen is read-only
+ sheet, the harness's own memory switch with its info sheet (2.19.0), the "Shared" row for harnesses whose memory every bot shares (2.25.0) and the handoff card. Since 2.21.0 the memory screen is read-only
(the user changes memory by telling the bot), so the port drops its add and edit controls. Port them from the
iPhone (`MemoryView.swift`, `MemoryFilesView.swift`, `MemoryInfoSheet.swift`, `HandoffRows.swift`).
diff --git a/docs/plans/harness-memory.md b/docs/plans/harness-memory.md
index 4d4804f1..91fc9c95 100644
--- a/docs/plans/harness-memory.md
+++ b/docs/plans/harness-memory.md
@@ -52,7 +52,8 @@ Mac e2e.
## Open questions
-- Gemini CLI's memory is one global `~/.gemini/GEMINI.md` shared by every Gemini session, not per bot. Say so in
- its detail text, or leave Gemini out.
+- Gemini CLI's memory is one global `~/.gemini/GEMINI.md` shared by every Gemini session, not per bot. Since 2.25.0
+ the memory screen says so for Gemini CLI and Hermes Agent ("Shared" with an info button,
+ [context and memory](../features/context-and-memory.md)).
- Codex's memories are off unless the user turns them on in their own config. Offer the choice when that config
has them on.
diff --git a/host/src/agent/own_memory.rs b/host/src/agent/own_memory.rs
index 2d16f266..92725c52 100644
--- a/host/src/agent/own_memory.rs
+++ b/host/src/agent/own_memory.rs
@@ -31,6 +31,14 @@ pub fn switchable(cfg: &BotConfig) -> bool {
}
}
+/// Whether the bot's harness keeps one memory of its own for all its sessions that Codync can't turn off: every bot
+/// on it, and the harness used outside Codync, share it. Gemini CLI's is `~/.gemini/GEMINI.md`, Hermes Agent's
+/// `~/.hermes/memories` ([design](../../../docs/design/bot-memory.md#instructions-in-every-harness)). The apps say so
+/// where other harnesses have a switch.
+pub fn shared(cfg: &BotConfig) -> bool {
+ matches!(cfg.backend.as_str(), "gemini" | "hermes")
+}
+
/// Whether the user kept the bot's harness's own memory on beside Codync's.
pub fn kept(cfg: &BotConfig) -> bool {
cfg.harness_memory && switchable(cfg)
@@ -167,6 +175,9 @@ mod tests {
assert!(kept(&bot("qwen", &own)));
assert!(!switchable(&bot("qwen", "/work/app")), "Qwen Code's lives in the project's own files");
assert!(!switchable(&bot("codex", &own)) && !switchable(&bot("gemini", &own)));
+ // Where there's no switch, the apps say when every bot on the harness shares its memory.
+ assert!(shared(&bot("gemini", &own)) && shared(&bot("hermes", "/work/app")));
+ assert!(!shared(&bot("claude", &own)) && !shared(&bot("codex", &own)));
let mut off = bot("claude", &own);
off.harness_memory = false;
assert!(!kept(&off));
diff --git a/host/src/hub/sync.rs b/host/src/hub/sync.rs
index 8f5b352a..2a881a72 100644
--- a/host/src/hub/sync.rs
+++ b/host/src/hub/sync.rs
@@ -15,6 +15,7 @@ impl Hub {
v["harnessMemory"] =
(!cfg.is_group() && crate::agent::own_memory::switchable(cfg)).then_some(cfg.harness_memory).into();
if !cfg.is_group() {
+ v["harnessMemoryShared"] = crate::agent::own_memory::shared(cfg).into();
v["sharedMemory"] = crate::chat::memory::shared(cfg).into();
v["memoryRev"] = self.store.memory_rev().into();
}
diff --git a/host/src/tui/app/mod.rs b/host/src/tui/app/mod.rs
index e3b5207f..a3b85227 100644
--- a/host/src/tui/app/mod.rs
+++ b/host/src/tui/app/mod.rs
@@ -16,7 +16,7 @@ mod ui;
pub use editor::Editor;
pub use exchange::{ConversationRow, Exchange, Item, Outcome, conversation, group, rows};
-pub use model::{After, AgentModel, Bot, Entry, Kind, Mark, ModelOption, Msg, Status};
+pub use model::{After, AgentModel, Bot, Entry, Kind, Mark, ModelOption, Msg, OwnMemory, Status};
pub use slash::SlashAction;
pub use ui::{
ACTIONS, Action, COLORS, Click, Confirm, ConfirmAct, Dir, FIELDS, FILTERS, Field, Focus, FolderPicker, Form, Goto,
diff --git a/host/src/tui/app/model.rs b/host/src/tui/app/model.rs
index edff4ef8..7c50df34 100644
--- a/host/src/tui/app/model.rs
+++ b/host/src/tui/app/model.rs
@@ -83,6 +83,15 @@ impl Mark {
}
}
+/// The harness's own memory as the bot's Memory screen shows it.
+#[derive(Clone, Copy, PartialEq, Eq, Debug)]
+pub enum OwnMemory {
+ /// Codync can turn it off: kept on, or off.
+ Switch(bool),
+ /// One memory for all the harness's sessions that Codync can't turn off (`own_memory::shared`).
+ Shared,
+}
+
#[derive(Clone, Debug)]
#[allow(clippy::struct_excessive_bools, reason = "mirrors the host's bot JSON")]
pub struct Bot {
@@ -114,8 +123,8 @@ pub struct Bot {
/// The bot that created this one; `None` when the user did.
pub created_by: Option<String>,
pub created_at: i64,
- /// The harness's own memory kept on beside Codync's; `None` where it has no switch.
- pub harness_memory: Option<bool>,
+ /// The harness's own memory beside Codync's; `None` where the screen says nothing about it.
+ pub harness_memory: Option<OwnMemory>,
/// Agents that carry on, in order, when its own can't answer (`agent::fallback`).
pub fallbacks: Vec<crate::store::Fallback>,
/// The bot may set its own fallbacks.
@@ -242,7 +251,10 @@ impl Bot {
manage_team: v["manageTeam"].as_bool(),
created_by: v["createdBy"].as_str().map(str::to_owned),
created_at: v["createdAt"].as_i64().unwrap_or(0),
- harness_memory: v["harnessMemory"].as_bool(),
+ harness_memory: v["harnessMemory"]
+ .as_bool()
+ .map(OwnMemory::Switch)
+ .or_else(|| (v["harnessMemoryShared"] == true).then_some(OwnMemory::Shared)),
fallbacks: serde_json::from_value(v["fallbacks"].clone()).unwrap_or_default(),
self_fallbacks: v["selfFallbacks"].as_bool().unwrap_or(true),
agent_step: v["agentStep"]["agent"].as_str().map(str::to_owned),
diff --git a/host/src/tui/manage/memory.rs b/host/src/tui/manage/memory.rs
index 682d1ca4..228cd45e 100644
--- a/host/src/tui/manage/memory.rs
+++ b/host/src/tui/manage/memory.rs
@@ -2,7 +2,7 @@
//! its notes, its dream log, and Claude Code's own memory where the user kept it on. The user changes memory by
//! telling the bot.
-use super::super::app::{App, Confirm, ConfirmAct, Overlay};
+use super::super::app::{App, Confirm, ConfirmAct, Overlay, OwnMemory};
use super::super::l10n::tr;
use super::s;
use super::{Page, Reply, ctrl};
@@ -262,7 +262,7 @@ impl App {
/// `m`: turns the harness's own memory off, or asks first, saying what it costs, before turning it on.
fn harness_memory_key(&mut self, mut m: MemorySheet) -> Option<Overlay> {
match self.bots.get(&m.bot).and_then(|b| b.harness_memory) {
- Some(true) => {
+ Some(OwnMemory::Switch(true)) => {
m.busy = true;
self.sheet(
"updateBot",
@@ -270,7 +270,7 @@ impl App {
Reply::MemorySaved(m.bot.clone()),
);
}
- Some(false) => {
+ Some(OwnMemory::Switch(false)) => {
// One line each in the confirmation: the info sheets' points, short.
let c = Confirm {
title: tr("Turn on {name}'s own memory?").replace("{name}", &self.harness_name(&m.bot)),
@@ -283,7 +283,7 @@ impl App {
self.overlays.push(Overlay::Confirm(c));
return None;
}
- None => {}
+ Some(OwnMemory::Shared) | None => {}
}
Some(Overlay::Memory(m))
}
diff --git a/host/src/tui/sheets/memory_view.rs b/host/src/tui/sheets/memory_view.rs
index db664ee4..238aa6b3 100644
--- a/host/src/tui/sheets/memory_view.rs
+++ b/host/src/tui/sheets/memory_view.rs
@@ -1,6 +1,7 @@
//! A bot's memory: about you, this bot's own, its dreams and Claude Code's own memory where it is kept on.
use super::{App, Buffer, Rect, centered, footer, frame_box, name_of, page_tabs, put, row, s, theme, u, window};
+use crate::tui::app::OwnMemory;
use crate::tui::l10n::tr;
use crate::tui::manage::{MemoryMode, MemorySheet, Page, Scroll, Section};
use crate::tui::md::{truncate, wrap};
@@ -77,13 +78,21 @@ fn entries(buf: &mut Buffer, body: Rect, app: &App, memory: &MemorySheet) {
let note = match (memory.section, view["shared"] == true, bot.and_then(|b| b.harness_memory)) {
(Section::Yours, true, _) => tr("Shared by your bots · s stops this bot using it").into_owned(),
(Section::Yours, false, _) => tr("This bot doesn't use what your bots share · s turns it on").into_owned(),
- (_, _, Some(true)) => tr("What this bot learned about you · {harness}'s own memory on · m turns it off")
- .replace("{harness}", &harness),
- (_, _, Some(false)) => tr("What this bot learned about you · {harness}'s own memory off · m turns it on")
- .replace("{harness}", &harness),
+ (_, _, Some(OwnMemory::Switch(true))) => {
+ tr("What this bot learned about you · {harness}'s own memory on · m turns it off")
+ .replace("{harness}", &harness)
+ }
+ (_, _, Some(OwnMemory::Switch(false))) => {
+ tr("What this bot learned about you · {harness}'s own memory off · m turns it on")
+ .replace("{harness}", &harness)
+ }
+ (_, _, Some(OwnMemory::Shared)) => {
+ tr("What this bot learned about you · {harness}'s own memory: shared by every {harness} bot")
+ .replace("{harness}", &harness)
+ }
(_, _, None) => tr("What this bot learned about you").into_owned(),
};
- put(buf, body.x, body.y, body.width, &note, palette.secondary.patch(palette.panel));
+ let top = caption(buf, body, &note);
let rows = memory.rows();
if rows.is_empty() {
let empty = tr(if memory.section == Section::Yours {
@@ -91,12 +100,12 @@ fn entries(buf: &mut Buffer, body: Rect, app: &App, memory: &MemorySheet) {
} else {
"Nothing yet. What this bot learns about you shows up here."
});
- put(buf, body.x, body.y + 2, body.width, &empty, palette.secondary);
+ put(buf, body.x, body.y + top, body.width, &empty, palette.secondary);
return;
}
- let height = usize::from(body.height.saturating_sub(2)) / 2;
+ let height = usize::from(body.height.saturating_sub(top)) / 2;
for (position, (index, e)) in rows.iter().enumerate().skip(window(memory.cursor, height)).take(height).enumerate() {
- let y = body.y + 2 + u(position * 2);
+ let y = body.y + top + u(position * 2);
let base = row(buf, body, y, index == memory.cursor);
let archived = e["state"] == "archived";
let text = format!("{}{}", if e["pinned"] == true { "● " } else { "" }, s(e, "text"));
@@ -128,10 +137,7 @@ fn dreams(buf: &mut Buffer, body: Rect, memory: &MemorySheet) {
from the chat: + added, − taken out or moved word for word into a note, which keeps one line per \
topic pointing to it. Pasted text and its replies never count. A record: to change a memory, tell \
the bot.";
- let muted = palette.secondary.patch(palette.panel);
- let lines = wrap(&[Span::styled(about, muted)], usize::from(body.width), &[], &[]);
- let top = u(lines.len()).min(body.height) + 1;
- Paragraph::new(lines).style(muted).render(Rect::new(body.x, body.y, body.width, top - 1), buf);
+ let top = caption(buf, body, about);
let rows = memory.rows();
if rows.is_empty() {
let empty = tr("No dreams yet.");
@@ -165,6 +171,16 @@ fn dreams(buf: &mut Buffer, body: Rect, memory: &MemorySheet) {
}
}
+/// `text` wrapped whole at the top of `body`, muted; returns how far down what goes under it starts.
+fn caption(buf: &mut Buffer, body: Rect, text: &str) -> u16 {
+ let palette = theme();
+ let muted = palette.secondary.patch(palette.panel);
+ let lines = wrap(&[Span::styled(text.to_owned(), muted)], usize::from(body.width), &[], &[]);
+ let top = u(lines.len()).min(body.height) + 1;
+ Paragraph::new(lines).style(muted).render(Rect::new(body.x, body.y, body.width, top - 1), buf);
+ top
+}
+
/// Both layers' long-form notes: name, where it lives, description, size and date, marked past a cap.
fn notes(buf: &mut Buffer, body: Rect, memory: &MemorySheet) {
let palette = theme();
@@ -266,4 +282,30 @@ mod tests {
assert_eq!(line(rows + 1).trim_end(), "No dreams yet.", "{width}");
}
}
+
+ #[test]
+ fn a_shared_harness_note_wraps_whole_and_the_entries_start_under_it() {
+ let (tx, _) = tokio::sync::mpsc::unbounded_channel();
+ let mut app = App::new(crate::tui::net::Client::new("http://127.0.0.1:1", None), tx, String::new());
+ let bot = serde_json::json!({"id": "b", "name": "B", "backend": "hermes", "harnessMemoryShared": true});
+ app.on_msg(crate::tui::app::Msg::Event(serde_json::json!({"type": "bot", "bot": bot})));
+ // An 80-column terminal leaves the sheet's body 74 wide.
+ let area = Rect::new(0, 0, 74, 12);
+ let mut buf = Buffer::empty(area);
+ let memory = MemorySheet {
+ bot: "b".into(),
+ view: Some(serde_json::json!({"bot": {"entries": []}})),
+ section: Section::Bot,
+ cursor: 0,
+ scroll: Scroll::default(),
+ mode: MemoryMode::Browse,
+ error: None,
+ busy: false,
+ };
+ entries(&mut buf, area, &app, &memory);
+ let line = |y: u16| (0..area.width).map(|x| buf[(x, y)].symbol()).collect::<String>();
+ let note = format!("{} {}", line(0).trim_end(), line(1).trim_end());
+ assert!(note.ends_with("shared by every hermes bot"), "{note}");
+ assert_eq!(line(3).trim_end(), "Nothing yet. What this bot learns about you shows up here.");
+ }
}
diff --git a/host/tests/fixtures/wire-shape.json b/host/tests/fixtures/wire-shape.json
index e31772d1..8ea778e9 100644
--- a/host/tests/fixtures/wire-shape.json
+++ b/host/tests/fixtures/wire-shape.json
@@ -22,6 +22,7 @@
"event:bot.bot.fastModeIssue": "null",
"event:bot.bot.fastModeSupport": "string",
"event:bot.bot.harnessMemory": "null",
+ "event:bot.bot.harnessMemoryShared": "bool",
"event:bot.bot.hidden": "bool",
"event:bot.bot.id": "string",
"event:bot.bot.kind": "string",