Starting a Chat¶
Chats are the core of Ogadu. There are two types: AI Chats for conversations with AI models, and Team Chats for human-only discussions.
Creating a Chat¶
- Open a project and go to the Chats tab (💬).
- Click New Chat.
- Configure the chat settings.
- Click Create Chat.
Editor or Admin required
You need the Editor or Admin role to create chats. Readers have view-only access.
Chat Types¶
AI Chat¶
Talk to an AI assistant powered by large language models.
| Setting | Details |
|---|---|
| AI Model | Choose which model powers the conversation. See AI Models. |
| AI Persona | Optionally select a custom persona for specialized behavior. See Personas. |
| Title | Optional. If left blank, Ogadu auto-generates a title after your first exchange. |
Team Chat¶
A human-only discussion space for your project members.
| Setting | Details |
|---|---|
| Title | Optional. |
Team chats don't use AI — they're for real-time conversations between team members. Each person's messages are color-coded for easy identification.
Locked after creation
The chat type, AI model, and persona cannot be changed after the chat is created. If you need a different model or persona, start a new chat.
Chat Interface¶
Header¶
The chat header shows:
- Chat title — click the pencil icon to edit (Editors and Admins).
- Type badge — "AI" or "Team."
- Model badge — the AI model name (AI chats only).
- Persona badge — the persona name with 🎭 (if a persona is selected).
- Project name — click to go back to the project.
Action Buttons¶
| Button | Description |
|---|---|
| Search | Search within the chat. |
| New To Do | Create a to-do linked to this chat. |
| Export | Copy the full chat as Markdown to your clipboard. |
| Branch | Create a copy of the entire chat. |
Message Input¶
- Enter to send, Shift + Enter for a new line.
- Messages support Markdown formatting.
- Maximum message length: 50,000 characters.
- AI chat placeholder: "Type your message..."
- Team chat placeholder: "Type your message to the team..."
Readers see a "You have read-only access to this chat" notice instead of the input area.
AI Response Streaming¶
In AI chats, responses are streamed in real time. You'll see the text appear progressively with a blinking cursor. Once the response is complete:
- A copy button appears on code blocks.
- Message action buttons (copy, link, branch) become available.
- If the chat had no title, one is auto-generated.
Deep Links¶
Every message has a Copy link action that generates a URL like:
https://ogadu.com/chat/{chatId}#msg-{messageId}
When someone opens this link, the page scrolls to that specific message and highlights it briefly. This is useful for pointing teammates to a specific part of a conversation.
Branching¶
Branching creates a copy of a conversation:
- Branch from a message — copies all messages up to (and including) the selected message.
- Branch entire chat — copies all messages.
The new chat gets the original title with "(branch)" appended. This is useful for exploring a different direction without losing the original conversation.