Skip to content

Conversations

A2A groups messages in two ways. A task is one unit of work: it runs, may stop to ask you something, and ends. A context is a conversation: a series of tasks the agent treats as related.

Command What it does
a2a send --task-id <id> "..." Answers a task that waits for input.
a2a send --context-id <id> "..." Starts a new task in the same conversation.
a2a chat Holds an interactive conversation.

Continue a conversation

Every result prints its context ID:

Task:     01a1d530-7e27-79f6-ad7a-9bcf5482d7b0
Context:  01a1d530-7d81-7026-91c8-63d4c55f3481
Status:   completed (2026-11-13T13:54:47Z)

Send the next message in the same context, and the agent sees the earlier ones:

a2a send -a localhost:8080 --context-id 01a1d530-7d81-7026-91c8-63d4c55f3481 "And the tests for it?"

Answer a question

A task in input-required waits for you. a2a prints the question and the command to answer it:

Task:     01a1d530-540a-791c-a4be-890667492c6a
Context:  01a1d530-540a-79b9-a234-eae4bf4a02f2
Status:   input-required (2026-11-13T13:54:36Z)
  Permission required: git push (git push origin main).

Resume:     a2a send --task-id 01a1d530-540a-791c-a4be-890667492c6a "<reply>"
a2a send -a localhost:8080 --task-id 01a1d530-540a-791c-a4be-890667492c6a "once"

A task in auth-required needs credentials first; see Credentials.

Chat

a2a chat keeps the context for you, and sends your next line as the answer when a task asks for input:

a2a chat -a localhost:8080 --stream
> What does this project do?
[status] working
[artifact] A command-line client for A2A agents.
[status] completed
> /exit
contextId: 01a1d531-0a3b-7c41-9d2e-6f1e2a3b4c5d
Key Does
/exit, /quit, Ctrl-D Ends the chat and prints the context and task IDs.
Ctrl-C during a turn Stops waiting and asks the agent to cancel the task. A second Ctrl-C stops waiting for the cancel.
Ctrl-C at the prompt Ends the chat.

Resume a chat with a2a chat --context-id <id>, adding --task-id <id> when a task waits for input. chat needs a terminal; scripts use send.