Talk to an agent

Ask an agent one question or hold a conversation with it from the terminal, and pick it up later.

graph ask runs one turn and exits. graph chat keeps the conversation open. Both start with the built-in chat agent unless you name another.

Ask one question

graph ask --agent release_notes \
  "What shipped since v0.15.0?"

The answer streams to stdout. Usage and a resume command follow on stderr:

3 calls · 12k in / 840 out · $0.04
resume with `graph chat --thread 0b9c2f6e-…`

Piped input is added to the message:

git diff main | graph ask "Review this diff"

Hold a conversation

graph chat release_notes

The prompt shows which agent you are talking to. Switch agents mid-conversation with /agent <name>, list them with /agent, and leave with /quit.

Pick it up later

Add --thread to continue the most recent conversation, or --thread <id> for a specific one. On graph ask, put it after the message:

graph chat

graph chat --thread

Related guides

Create an agent in the workbench

Draft and save an agent to talk to.

Manage threads

Find, inspect and delete past conversations.

Build a multi-agent network

Let agents hand the conversation to each other.

Customize a built-in agent

Change the default chat agent.