diff --git a/plugins/memory/honcho/cli.py b/plugins/memory/honcho/cli.py
index f0cff433f6..8fe21c52dc 100644
--- a/plugins/memory/honcho/cli.py
+++ b/plugins/memory/honcho/cli.py
@@ -1146,8 +1146,7 @@ def _preview_peer_resolution(
     return sanitize(user_id)
 
 
-# Picker cap: workspaces holding thousands of peers (public bots) must not
-# stall the CLI on an exhaustive listing.
+# Workspaces holding thousands of peers (public bots) must not stall the CLI.
 _PEERS_MAP_FETCH_CAP = 200
 
 
diff --git a/plugins/memory/honcho/client.py b/plugins/memory/honcho/client.py
index 215325fe79..1aa05f1c8b 100644
--- a/plugins/memory/honcho/client.py
+++ b/plugins/memory/honcho/client.py
@@ -395,8 +395,8 @@ class HonchoClientConfig:
     session_peer_prefix: bool = False
     # Bot-authored DMs write into their own session per sender bot.
     a2a_sessions: bool = True
-    # Symmetric to session_peer_prefix: several AI peers sharing one workspace, peerName and gateway
-    # chat key would otherwise resolve to the same session name.
+    # Prefixes every resolved session name with ``{ai_peer}-``. The gateway_session_key branch is
+    # AI-peer-agnostic, so several AI peers sharing one workspace + peerName + chat key would collide.
     session_ai_peer_prefix: bool = False
     sessions: dict[str, str] = field(default_factory=dict)
     raw: dict[str, Any] = field(default_factory=dict)