Chat & Conversations

Starting a conversation

When you log in, Codumentor opens your most recent conversation. To start a fresh one, click New conversation at the top of the thread list (left sidebar).

Each conversation is independent — it has its own context and history. You can have as many as you like.

Sending messages

Type your message in the input area at the bottom and press Enter to send. For multi-line messages, press Shift+Enter to add a new line.

The assistant streams its response in real time. You'll see text appear as it's generated, along with any tool calls it makes.

Interrupting and redirecting

While the assistant is responding, the Send button changes to Stop. Click it (or press Enter with an empty input) to cancel the current response.

If you start typing while the assistant is responding, the button changes to Stop & Send. This cancels the current response and immediately sends your new message — useful when you see the assistant going in the wrong direction and want to redirect it.

Thread list

The left sidebar shows your conversations, sorted by most recent activity. Each thread shows:

• A title (auto-generated from the first message, or renamed by you)
• A time indicator (e.g., "5m ago", "Yesterday")

On a user-home instance (community: install once, run from any folder) the sidebar defaults to This folder — conversations tagged with the current workspace. All shows every conversation, including untagged ones from before this filter existed. Workspace-home servers have a single workspace, so the toggle is hidden.

Thread actions

Right-click a thread (or use the context menu) to:

• Pin / Unpin — pinned threads stay at the top of the list
• Rename — give the conversation a custom title
• Delete — soft-delete the conversation (you can undo immediately)

On mobile, tap the hamburger menu icon in the header to open the thread list.

Navigating within a conversation

Scroll up to see earlier messages. A scroll-to-bottom button appears when you've scrolled away from the latest messages.

Deep links

Every conversation has a shareable URL like /c/abc123. You can bookmark these or share them (see Sharing).

You can also link directly to a specific message: /c/abc123/t/msg456 — this scrolls to and highlights that message when opened.

Tool calls in the transcript

When the assistant uses tools (searching code, running commands, writing files), you'll see collapsible cards in the transcript showing:

• The tool name and what it's doing
• The result or output
• Status (running, completed, or failed)

Click on a tool card to expand or collapse the details. When there are many tool calls in sequence, they're grouped together — click to expand the group.

Mermaid diagrams in assistant messages

Codumentor can render Mermaid code fences directly in assistant responses. For example:

flowchart TD
A[Start] --> B[Next Step]

Behavior notes:

• Mermaid rendering is available in the Web UI.
• During streaming, Mermaid blocks are shown as raw source first, then rendered after the response completes.
• If diagram rendering fails, the original Mermaid source remains visible so the content is not lost.

Max turns

The assistant has a configurable limit on how many tool-calling steps it can take per message. If it reaches this limit, you'll see a banner with a Continue button. Click it to let the assistant keep working.

Voice conversation

When your administrator has enabled Voice Mode and configured speech, a Start voice conversation button appears on the chat input. It opens a full-screen overlay: just start talking. The assistant waits until you have finished a request, then works and speaks the answer back. Captions stay on screen.

While it is working you can keep talking to refine the same task, change the goal, or say stop. Tool approvals still appear in the overlay as Approve / Deny (spoken yes/no is off unless your administrator turned it on).

This is different from push-to-talk (hold the mic button to dictate one message into the input) and from read aloud (play a finished message). Click End to leave the overlay; the conversation keeps the turns that were sent.

The browser will ask for microphone permission. Use a secure origin (HTTPS, or localhost). If the button is missing, Voice Mode is not available on this instance — ask your administrator.