Skip to main content
The Chat Console lets you talk to your agents directly from the browser. You can start new conversations, review past sessions, and watch your agents think and respond in real time. Who it’s for: anyone testing an agent’s behavior before exposing it on a real channel, plus developers debugging tool calls live.

​
Routes

  • /chat — opens the console without a selected session
  • /chat/:sessionKey — opens directly to a specific session (e.g., chat/web:default:abc-123)

​
Backing API

  • POST /api/chat — sends a new message; body is JSON { message, agentId?, sessionKey? }
  • GET /api/chat/history — loads message history for a session
  • SSE events on the dashboard’s event stream drive the streaming response (token-by-token append, tool call status updates, completion)
All requests carry the gateway token as a Bearer header (read from sessionStorage.comis_token).

​
What You See

The Chat Console is split into two main areas side by side.

​
Session Sidebar

On the left, the session sidebar lists all of your conversations. Each session shows the session key, the agent and channel it belongs to, and the last time it was active. At the top of the sidebar you will find:
  • A New Session button (labelled “New”) that creates a fresh session for the agent currently selected in the message area
  • A search bar (“Filter sessions…”) that filters the visible session list by session key, agent ID, or channel type as you type
Click any session in the list to load its conversation in the message area.
For richer filtering — by agent, channel, or content match across all sessions — use the Sessions view instead. The chat console’s sidebar is a quick filter, not a full session browser.

​
Message Area

On the right, the message area shows the full conversation history for the selected session. Messages are displayed as bubbles with different styles depending on who sent them:
  • Your messages appear on the right side
  • Agent responses appear on the left side with support for formatted text, lists, code blocks, and other rich content
  • System messages appear centered with a distinct style
  • Error messages are highlighted in red so they stand out
At the top of the message area, a header bar shows the session key, the agent handling the conversation, and the channel type.

​
Tool Call Cards

When your agent uses tools behind the scenes — like searching the web, reading a file, or running a command — the Chat Console shows expandable cards in the conversation. Each card displays:
  • The tool name
  • The input parameters the agent sent to the tool
  • The output the tool returned
  • Whether the tool call succeeded or encountered an error
Click a tool call card to expand it and see the full details. These cards help you understand exactly what your agent did to arrive at its answer.

​
Message Input

At the bottom of the screen, a text input lets you type messages to your agent. The input area automatically grows as you type longer messages.

​
Starting a Conversation

1

Pick the agent you want to talk to

At the top of the message area, use the agent selector dropdown to choose which agent the next session will be created for.
2

Click New

Click the New button at the top of the session sidebar. A fresh session is created for the selected agent on the web channel; its session key is auto-generated as web:<agent>:<uuid>. The new session is selected immediately.
3

Send your first message

Type your message in the input area at the bottom and press Enter to send it. The conversation streams back word-by-word.
The chat console always uses the web channel for sessions it creates. To converse with an agent over a real platform (Telegram, Discord, etc.), send a message from that platform — the daemon will create the session there.

​
During a Conversation

Once you send a message, the agent starts working on a response. Here is what to expect:
  • Live streaming — The agent’s response appears word by word as it is generated, so you do not have to wait for the entire reply before you start reading.
  • Formatted responses — Agent messages render with full formatting support including bold text, bullet lists, code blocks, and links.
  • Tool activity — If the agent calls tools during its response, you will see tool call cards appear in the conversation stream. These show what the agent is doing behind the scenes.
  • Errors — If something goes wrong during the response, an error message appears in red with details about what happened.
Keyboard shortcuts:
  • Press Enter to send your message
  • Press Shift + Enter to insert a new line without sending
  • Use the scroll-to-bottom button that appears when you scroll up in a long conversation
You can also type slash commands in the message input for quick actions: /new (start a new session), /reset (reset the current session), /compact (compact the current session context), /export (download the session as JSONL), /switch (change agent), and /help (see all commands).

​
Attachments and Voice

The Chat Console supports file attachments and voice recordings alongside text messages:
  • File attachments — Click the attachment button to attach images, audio files, or documents to your message. You can attach up to 5 files at a time, each up to 10 MB.
  • Voice recording — Use the microphone button to record a voice message up to 2 minutes long. The recording is sent to your agent for transcription and processing.
Attachment previews appear above the message input before you send, so you can review and remove files before they go out.

Sessions View

Browse all sessions with filtering, bulk actions, and detailed statistics.

Agents View

View and manage the agents you are chatting with.