Context
When one clanker instance communicates with another (e.g. via subagent delegation, MCP, or collaboration modes), the TUI currently shows only the local clanker's avatar. There is no visual representation of the remote agent's identity.
For clanker-code's identity-first vision, when Pilgrim talks to HAI, the TUI should show both avatars — Pilgrim on one side, HAI on the other — making the conversation feel like a dialogue between two embodied agents, not a monologue with tool calls.
What is needed
-
Remote avatar discovery. When a clanker-to-clanker session is established (via collaboration mode, subagent spawning, or MCP), the remote agent's character manifest (name, avatar) should be discoverable. This could be via:
- Protocol exchange (the remote agent advertises its identity on connection)
- Shared character registry
- Manual configuration
-
Dual-avatar TUI layout. The TUI should support displaying two avatars:
- Local avatar (left/top) — the current user's clanker persona
- Remote avatar (right/bottom) — the peer clanker's persona
- The remote avatar animates (talking, idle) based on whose turn it is in the conversation
-
Graceful fallback. If the remote agent's avatar is unavailable (e.g. upstream codex agent without character manifest), show a generic placeholder or just the name.
-
Multi-peer support. In collaboration modes with more than two agents, the TUI should handle displaying multiple peer identities (at minimum their names, ideally small avatars).
Depends on
Relationship to existing issues
Acceptance criteria
Context
When one clanker instance communicates with another (e.g. via subagent delegation, MCP, or collaboration modes), the TUI currently shows only the local clanker's avatar. There is no visual representation of the remote agent's identity.
For clanker-code's identity-first vision, when Pilgrim talks to HAI, the TUI should show both avatars — Pilgrim on one side, HAI on the other — making the conversation feel like a dialogue between two embodied agents, not a monologue with tool calls.
What is needed
Remote avatar discovery. When a clanker-to-clanker session is established (via collaboration mode, subagent spawning, or MCP), the remote agent's character manifest (name, avatar) should be discoverable. This could be via:
Dual-avatar TUI layout. The TUI should support displaying two avatars:
Graceful fallback. If the remote agent's avatar is unavailable (e.g. upstream codex agent without character manifest), show a generic placeholder or just the name.
Multi-peer support. In collaboration modes with more than two agents, the TUI should handle displaying multiple peer identities (at minimum their names, ideally small avatars).
Depends on
AGENT_PERSONA) — identity resolution for the local sideRelationship to existing issues
Acceptance criteria