Guides/Agent Chat

Agent Chat

The Chat tab in Agent Detail provides a bubble UI for conversing with agents, with persistent history and real-time status updates.

Watch

All videos

I Gave My AI Three Years of My Notes — Then Interviewed It

May 2026

Stateless Chat

This tab is stateless: each message starts fresh, replaying the visible transcript as text. It is labelled as such — Stateless chat — each message starts fresh. — with a Continue in Workspace → link beside it that opens the Workspace in its own browser tab.

For a conversation where the agent keeps its working memory between turns — tool results, mid-task state, reasoning — use the Workspace instead. The Session-mode toggle that used to live here has been retired in its favour, and ?tab=session links now redirect there.

The tab is text only. Voice lives in the Workspace: the Talk button in the agent's header opens the Workspace on this agent with a call starting — see Voice Chat. Calls you had here before that change are still in their sessions, badged Voice.

Concepts

•Chat Session — A conversation thread stored in the database. Each agent can have multiple sessions.

•Dynamic Thinking Status — Real-time labels showing what the agent is doing (replaces static “Thinking...”). Maps tool names to human-readable labels with 500ms anti-flicker.

•Playbook Autocomplete — Type / in the chat input to trigger a dropdown of available playbooks. Ghost text shows command syntax with argument hints.

•Continue as Chat — Resume a completed or failed execution as an interactive chat, preserving the full context (150K+ tokens) via Claude Code's --resume flag.

How It Works

Open an agent's detail page and click the Chat tab.

Select an existing session from the dropdown or click New Chat.

Optionally pick a model in the Default model dropdown above the input; empty means the agent's default. The choice is remembered in this browser.

Type a message and press Enter.

The agent processes the message — the status label updates in real-time (e.g., “Reading files...”, “Running tests...”).

The response appears as a chat bubble.

Type / to autocomplete playbook commands.

Stopping a Turn

While a turn runs, Send becomes Stop. Click it, or press Escwith nothing else open, to cancel the in-flight turn: the turn ends as cancelled (not failed) and your message text returns to the input, in front of anything you typed while waiting. A cancel that loses the race to the reply says nothing — the reply is already on screen. A refused cancel leaves the input untouched and says the turn is still running. Stop is available once the turn has an execution id, which takes about a second.

File Attachments

Attach files using the paperclip button or drag-and-drop onto the chat input.

Supported types

•Images (JPEG, PNG, GIF, WebP) — passed as vision content blocks

•Plain text, CSV, JSON, and ZIP — written to /home/developer/uploads/ inside the agent container and readable by name; a ZIP is stored as-is, not extracted

•The paperclip picker filters to images and text-like files — drop a ZIP onto the input instead

•Unsupported: PDF, tar, gzip, rar, video, audio

Limits per message

Max files	3
Max size per file	5 MB
Max total image size	10 MB

Oversized files are rejected client-side. Files exceeding limits are skipped with a note appended to the message context. File uploads work in both authenticated and public chat.

Continue as Chat

•From the Execution Detail page, click Continue as Chat.

•This opens the Chat tab with a resume banner showing execution context.

•Uses --resume {session_id} for native session continuity.

Session Management

•Sessions persist across container restarts.

•Close a session: POST /api/agents/{name}/chat/sessions/{id}/close

API Endpoints

Endpoint	Method	Description
/api/agents/{name}/chat	POST	Send chat message (stream-json output)
/api/agents/{name}/chat/sessions	GET	List all sessions
/api/agents/{name}/chat/sessions/{id}	GET	Get session with messages
/api/agents/{name}/chat/sessions/{id}/close	POST	Close session
/api/agents/{name}/chat/history/persistent	GET	Get persistent history
/api/agents/{name}/chat/history	DELETE	Reset session
/api/agents/{name}/executions/{id}/terminate	POST	Stop an in-flight turn (what Stop calls)

MCP Tools

•chat_with_agent(agent_name, message) — Send a message to an agent.

•get_chat_history(agent_name) — Retrieve chat history for an agent.