Chat Interface
The Obsilo sidebar is where you talk to the agent, attach files, browse past conversations, and watch the agent work as it goes.
The chat panel
Open Obsilo by clicking its icon in the left sidebar. The panel has three areas:
- Toolbar at the top: mode selector, model picker, history button
- Message area in the center: your conversation, activity blocks, approval cards
- Input bar at the bottom: text field, attachment button, send button
Sending messages
Type your message and press Enter to send. For multi-line messages, press Shift+Enter to add a new line.
Configurable send key
In Settings > Obsilo Agent > Interface you can change the send shortcut to Ctrl+Enter (or Cmd+Enter on Mac) if you prefer Enter for new lines.
Attachments
Three ways to attach a file:
- Drag and drop from your desktop or file manager onto the chat input
- Paste from clipboard (screenshots and copied images are added automatically)
- Click the paperclip icon next to the input field to browse your files
Supported file types
| Type | Examples | Notes |
|---|---|---|
| Images | PNG, JPG, GIF, WebP | The agent can see and describe image content |
| Office documents | PPTX, DOCX, XLSX | Content is extracted and added as context |
| Any PDF file | Text is extracted for the agent to read | |
| Text files | Markdown, TXT, CSV, JSON | Added as plain text context |
50 MB Limit
Each attachment can be up to 50 MB. Very large files may use a significant portion of the model's context window, leaving less room for conversation.
@-Mentions
Type @ in the input field to search your vault by file name. A dropdown appears as you type, showing matching notes. Select a file to attach it as context. This is the fastest way to point the agent at a specific note without leaving the chat.
Example: "Summarize @meeting-notes-march and compare the action items with @project-roadmap"
Workflow and prompt picker
Type / in the input field to open the picker. It lists workflows (multi-step task templates like "research a topic" or "reorganize a folder") and support prompts (pre-written prompts for common tasks). Pick one to insert into your message. You can edit the text before sending.
Activity blocks
When the agent works, an activity block appears below its response and shows every tool call as it happens:
- The tool name and key parameters (which file was read, what query was used)
- A result preview (click to expand and see full details)
- Diff badges on write operations showing lines added and removed (e.g.,
+12 / -3)
Activity blocks collapse by default after the agent finishes. Click to expand them again whenever you want.
Full transparency
You can always see exactly what the agent did, which files it read, and what it changed.
Approval cards
When the agent wants to perform a write operation (and auto-approve is off for that category), an approval card appears. It shows what the agent plans to do and gives you three choices:
- Allow once: approve this single action
- Always allow: auto-approve this category from now on
- Deny: reject the action
See Safety & Control for details on permission categories.
The undo bar
After the agent finishes a task that changed files, an undo bar appears at the bottom of the conversation. Click Undo to revert all changes made during that task. Every modified file is restored from its checkpoint.
The undo bar stays visible until you start a new message or dismiss it.
Chat history
Obsilo saves every conversation automatically. To access your history:
- Click the history icon in the toolbar (clock symbol)
- Browse past conversations, each showing a title, date, and preview
- Click a conversation to restore it and continue where you left off
Conversations are titled automatically based on their content. You can also jump to linked conversations directly from your notes. See Memory & Personalization for chat-linking.
Context display and condensation
At the top of the message area, a small indicator shows how much of the model's context window is in use. As conversations grow longer, Obsilo may condense earlier messages to stay within limits. When that happens, a brief note appears in the conversation, key facts and decisions are kept, and older tool call details may get summarized. It runs automatically so long conversations keep going.
Keyboard shortcuts
| Shortcut | Action |
|---|---|
Enter | Send message (configurable) |
Shift+Enter | New line in input |
@ | Open file mention picker |
/ | Open workflow/prompt picker |
Escape | Close picker or cancel current input |
Tips
- Attach files instead of pasting long text. Attachments are handled more efficiently.
- Use @-mentions when you know which note you want. It is faster and more precise than asking the agent to search.
- Skim activity blocks after the agent works. They show you what tools exist and how the agent thinks about tasks.
- Start a new conversation for unrelated topics so context stays focused and you avoid condensation.
Next steps
- Vault Operations: What the agent can do with your files
- Knowledge Discovery: Set up semantic search for better results
- Safety & Control: Permissions, checkpoints, and the audit log