Organize and Search Chats¶
Use the sidebar to keep active conversations close at hand, search earlier messages, or share a read-only snapshot. On narrow screens, open the sidebar button first to reach these controls.
Pin or rename a chat¶
Open the ... (Chat actions) menu beside any conversation in the sidebar:
- Select Pin chat to keep it in the Pinned section at the top of the list, or Unpin chat to return it to its date group.
- Select Rename, type a new title, and press Enter (or Escape to cancel).
The menu appears on hover or keyboard focus, and is always accessible on touchscreens. You can also navigate its items with the arrow keys.
Archive a finished conversation¶
- Open Chat actions (
...) and select Archive. - Switch to the Archived tab at the top of the sidebar whenever you want to browse or search archived threads.
- Select Unarchive from the chat's menu to move it back to the active Chats list.
Archiving hides a conversation from the main list while keeping all of its messages and files intact. Delete is a separate action that asks for confirmation and permanently removes the chat.
Continue with another model¶
Each conversation keeps the model it was started with so its history and reasoning format stay consistent. To try a different model from any point in a thread:
- Hover over an assistant reply and click the branch icon (Continue with another model).
- Pick the target model from the selector.
Numi copies the conversation up to that reply (including questions, answers, tool calls and results, citations, uploads, and generated files) into a new linked chat for the chosen model and opens it immediately. Any unsent text or attachments in your composer move with you into the new chat, and an Open original link above the composer takes you back to the source thread.
- The original conversation stays untouched.
- Reasoning traces, usage totals, and unselected response versions stay in the original chat, since reasoning traces are specific to the model that produced them.
- Copied messages provide context for the new model without re-triggering automatic memory extraction, and no model call runs until you send your next message.
- Uploaded PDFs reuse their extracted page text without re-running OCR.
Send a message while Numi works¶
You can type and send follow-up input while an answer is still streaming:
- Press Enter (or click the send button) to queue your message for the next safe boundary: right after the current tool batch finishes, or as a follow-up turn if the model finishes answering without calling more tools.
- While the composer is empty, the primary button acts as Stop generation; as soon as you type, it switches back to sending/queuing.
- Queued messages never interrupt a running tool or slip between a tool call and its result. During Deep Research, queued input waits for the active worker wave to finish.
Up to ten messages can wait in a chat's queue above the composer. You can pull a queued message back into the composer to edit it or remove it before it starts running. Queued messages persist across page reloads and server restarts; if a turn stops due to cancellation or an error, click Send now to run the queued message or remove it.
Share a conversation¶
- Click Share at the top right of an open chat (or choose Share from Chat actions).
- Pick an expiration window: Never, or 1, 7, or 30 days.
- Click Create link and copy the URL.
Anyone with the link can view a read-only snapshot of the conversation as it existed when the link was created, without signing in:
- Frozen in time: Messages you send or edit later stay private. Create a new share link if you want to publish an updated snapshot.
- Revocable anytime: The Shared links list in the same dialog shows
every active link for the chat with Copy and Delete controls. Deleting
a link (or deleting the chat) disables
/s/{token}immediately. - Privacy filtering: Shared snapshots exclude memory lookups, personal file
reads, and token/cost usage, and show uploaded attachments by filename only.
Assistant-generated files (such as charts or documents) remain viewable, and
noindexheaders instruct search engines not to index the page.
Find a message¶
- Select either the Chats or Archived tab in the sidebar.
- Click Search chats... (or press Ctrl/Cmd+K) and type a word or phrase.
- Click a matching result. Matching a message opens the chat scrolled directly to that message and briefly highlights it; matching a title opens the conversation normally.
Search scans chat titles, user messages, and assistant replies, showing one entry per matching conversation with a preview snippet. Clear the search box to return to the full chronological list.
API access¶
For scripts and custom clients, use the authenticated chat endpoints:
| Request | Purpose |
|---|---|
PATCH /api/v1/chats/{chat_id}/organization |
Update pinned, archived, or both |
GET /api/v1/chats/?archived=false&limit=20 |
List active (unarchived) chats |
GET /api/v1/chats/?archived=true&limit=20 |
List archived chats |
GET /api/v1/chats/search?q=architecture |
Search across active and archived chats |
Example request to pin and unarchive a chat:
curl -X PATCH http://localhost:4567/api/v1/chats/YOUR_CHAT_UUID/organization \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"pinned": true, "archived": false}'
Search returns up to 50 chat objects, each including a snippet and a nullable
message_id pointing to the first matching message in that chat.