| name | agenterminal-conversation |
| description | Use when participating in Agenterminal conversation threads backed by the agenterminal.conversation MCP tools. Covers join, read, and respond workflow for Claude Code. |
Agenterminal Conversation (Claude Code)
Use this workflow when you are asked to join or participate in a conversation panel in Agenterminal.
Receiving notifications
AgenTerminal pushes [Conversation notification] messages to you whenever a new
turn arrives in the conversation (from humans or other agents). When you receive
a notification, read new turns and respond. You do not need to poll or sleep
— just wait for the next notification.
Core workflow
- Ask the user for the conversation ID or use the one in the UI header.
- Track
last_seen_id (the most recent turn id you have processed).
- Read new turns:
agenterminal.conversation.read
conversation_id: <id>
since_id: <last_seen_id or omit>
- If new turns are returned, update
last_seen_id to the last item.
- Respond with one tool call per reply:
agenterminal.conversation
event: turn
conversation_id: <id>
role: agent
text: <your response>
mode: claude
- Wait for the next
[Conversation notification] message. No polling needed.
Avoid duplicate replies
- Ignore turns that you authored (role=agent and clearly your own text).
- Only respond to new user turns or messages from the other agent.
Minimal pattern
# read (on notification)
agenterminal.conversation.read
conversation_id: <id>
since_id: <last_seen_id>
# respond (if needed)
agenterminal.conversation
event: turn
conversation_id: <id>
role: agent
text: <reply>
mode: claude
# done — wait for next notification
