Register the current iTerm2 session with a task ID.

This allows other Claude Code sessions to find and communicate with this session using the task ID.

Args: task_id: Unique identifier for this session (e.g., "task-a", "feature-auth"). Must be alphanumeric with hyphens/underscores, max 64 chars.

Returns: Result indicating whether registration succeeded.

Example: >>> register_session("task-a") RegisterSessionResult(success=True, task_id="task-a", ...)

List all registered active iTerm2 sessions.

Use this to discover which other Claude Code sessions you can communicate with.

Returns: List of active sessions with their task IDs.

Example: >>> list_sessions() ListSessionsResult( sessions=[ Session(task_id="task-a", ...), Session(task_id="task-b", ...), ], total_count=2, ... )

Send a message to a specific Claude Code session.

Use this to communicate with another Claude instance working on a related task. The message will be injected into the target session.

Args: target_task_id: Task ID of the target session (e.g., "task-b"). content: The message content to send. source_task_id: Your current task ID (the sender). priority: Message priority: "normal", "high", or "urgent".

Returns: Result indicating whether the message was sent.

Example: >>> send_message("task-b", "PR merged to main, please pull latest", "task-a") SendMessageResult(success=True, message_id="msg_abc123", ...)

Broadcast a message to all other active Claude Code sessions.

Use this to notify all other sessions about important events, like when a PR is merged to main.

Args: content: The message content to broadcast. source_task_id: Your current task ID (the sender). priority: Message priority: "normal", "high", or "urgent".

Returns: Result indicating how many sessions received the message.

Example: >>> broadcast_message("PR #123 merged to main, please pull latest", "task-a") SendMessageResult(success=True, delivered_to=["task-b", "task-c"], ...)

List messages received by this session.

Use this to see what other sessions have communicated to you.

Args: current_task_id: Your current task ID. unread_only: Only show messages not yet acknowledged.

Returns: List of messages with metadata.

Example: >>> list_messages("task-a", unread_only=True) ListMessagesResult(messages=[...], unread_count=3, ...)

Mark a message as read/acknowledged.

Use this after you've processed a message to remove it from your unread messages.

Args: message_id: The ID of the message to acknowledge. current_task_id: Your current task ID.

Returns: Result indicating whether acknowledgement succeeded.

Example: >>> acknowledge_message("msg_abc123", "task-a") AcknowledgeMessageResult(success=True, ...)