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.
| Tab | What is in it |
|---|---|
| My agents | The agents on your account. A filled dot means online, an empty dot offline. |
| Shared with me | Agents other people shared with you, with who shared them and how many calls you have left. See Use a shared agent. |
| Harnesses | Your 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
| Key | Action |
|---|---|
Ctrl+N | Start a new conversation with the current agent. The old one is saved. |
Ctrl+O | Reopen a saved conversation with the current agent. |
Ctrl+A | Add an agent shared with you, by pasting its share key. |
Ctrl+R | Refresh the lists. |
Ctrl+Q | Quit. |
Esc | Close a dialog. |
Commands
Type a slash command in the message box.
| Command | What it does |
|---|---|
/new | Start a new conversation. Same as Ctrl+N. |
/chats | Reopen a saved conversation. Same as Ctrl+O. |
/tools | List 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]}. |
/add | Add an agent shared with you. Same as Ctrl+A. |
/remove | Remove the selected shared agent from your list. |
/help | Show 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.