Your First Chat

Once a provider is set up and at least one model is available, you are ready to chat.

Start a New Chat

Click New Chat in the sidebar or press Ctrl+N. AgentOne opens a fresh conversation with an empty-state greeting such as What's on your mind? or Ask me anything.

Pick a Model

At the bottom of the chat window, the model selector shows the currently active provider and model. Click it to open the full model list, which is grouped by provider. Type in the search field to filter quickly.

The model you choose applies to this chat. You can switch models at any point in the conversation - changes take effect on the next message you send.

Write and Send Your Message

Type in the Ask anything... input field. By default, pressing Enter sends the message. If you prefer Ctrl+Enter, change this in Settings -> Chats -> Submit Key.

AgentOne streams the response token by token so you can start reading immediately. A stop button appears in the composer while the model is generating - click it to interrupt the response at any time.

Attach Files

The composer supports several ways to add files to your message:

• Paperclip button - click it to open a file picker.
• Drag and drop - drag files from your file manager directly onto the composer. A drop target labeled Drop files or chats to attach appears when you hover.
• Paste - paste an image or file from your clipboard.

You can also drag an existing chat from the sidebar into the composer. AgentOne exports that chat into an attachment so the current conversation can reference it - useful when you want context from a previous conversation without switching away.

For more detail on supported file types and attachment behavior, see Attachments.

Tune the Chat

Next to the model selector is the model config button. Click it to open the Model Config panel where you can adjust:

• Temperature - randomness of the output.
• Max Tokens - cap on response length.
• Top P, Top K - alternative sampling controls.
• Max Steps - relevant for extension-heavy workflows.
• And more.

These settings apply only to the current chat and do not affect other conversations unless you change them on the New Chat screen.

Message Actions

After the model responds, hover over any message to see the action row:

• Copy message - copies the message content.
• Regenerate response - generates a fresh answer from the same conversation state.
• Edit message - edit any message, including assistant messages, and optionally regenerate from that point. If you don't want the assistant messages to be regenerated when you edit your message, click the dropdown arrow next to the Save button and ensure Regenerate when saved is not checked.
• Branch conversation - fork the chat at that message into a new conversation.

When a text-to-speech provider is set up, a speaker icon also appears on assistant messages for reading them out loud.

See Message Actions for full details.

What Comes Next

• Search Chats - find any past conversation.
• Extensions - give the model tools like web search, file editing, and command execution.
• Reading Aloud - listen to messages with text-to-speech.
• Settings - customize how the app looks and behaves.