Skip to Content
AdunemDocs
GuidesCLI referenceHelp

chat

A full-screen terminal app to talk to your own agents, agents shared with you, and live harnesses.

adunem chat opens a full-screen chat app in your terminal. Pick an agent on the left, type a message, and read its answer, without leaving the terminal. It is the terminal version of the Agents pages and the playground in the dashboard.

You must be signed in. If you are not, chat stops before it opens the screen, with not logged in to <gateway>; run adunem login.

Usage

adunem chat [--gateway <url>]

Options

--gateway, -gtextdefault: your last gateway

Which Adunem to connect to.

The screen

The left panel has three tabs. Switch tabs with the left and right arrow keys, move with up and down, and press Enter to open an item.

TabWhat is in it
My agentsThe agents on your account. A filled dot means online, an empty dot offline.
Shared with meAgents other people shared with you, with who shared them and how many calls you have left. See Use a shared agent.
HarnessesYour harnesses and ones shared with you. A Live harness answers your questions. A Package harness is for installing, so it only shows its details. See harness.

The right side shows the conversation. The line under the title shows whether the agent is online, who shared it, and calls left. Type in the box at the bottom and press Enter to send.

An agent that is offline cannot answer. For one of your own, start it with adunem connect.

Keys

KeyAction
Ctrl+NStart a new conversation with the current agent. The old one is saved.
Ctrl+OReopen a saved conversation with the current agent.
Ctrl+AAdd an agent shared with you, by pasting its share key.
Ctrl+RRefresh the lists.
Ctrl+QQuit.
EscClose a dialog.

Commands

Type a slash command in the message box.

CommandWhat it does
/newStart a new conversation. Same as Ctrl+N.
/chatsReopen a saved conversation. Same as Ctrl+O.
/toolsList the current agent's tools.
/call <tool> {json}Call one tool directly, with arguments as a JSON object. For example /call calculate {"operation":"sum","numbers":[1,2]}.
/addAdd an agent shared with you. Same as Ctrl+A.
/removeRemove the selected shared agent from your list.
/helpShow this help.

Agents without a chat tool

Chatting needs the agent to have a tool named chat. For an agent without one, the screen says so. Use /tools to see what it offers and /call to run a tool. This is also how you use a shared agent that only offers specific tools.

Where conversations are saved

Conversations are saved only on your computer, in the chats folder of the CLI's config folder, and are readable only by you. Each message sends the most recent 20 turns as context, and a saved conversation keeps up to 500.

Harness conversations are kept in memory only, and are gone when you quit.

Add a shared agent

If someone gave you a share key (it starts with amsh_), press Ctrl+A and paste it. The input is hidden. The agent appears under Shared with me and is added to your account, so you will see it in the dashboard's Shared with me page and on your other machines. You can also do this from a script with adunem share add.

Shares sent to your email appear on their own, with no key.

On this page