Chat History & Session Management

​

Overview

MyrmAgent provides a comprehensive chat history management system integrated directly into the sidebar — no separate page needed. Every conversation is organized, searchable, and exportable from one place.

​

Full-Text Search (Cmd+K)

Press ⌘+K (macOS) or Ctrl+K (Windows/Linux) anywhere in the app to open the global search dialog.

• Instant results: Debounced search queries the backend /chats/search API
• Time range filtering: Narrow results to Today, This Week, This Month, or This Quarter
• Snippet highlighting: Matching text is highlighted in search results
• Click to jump: Select a result to navigate directly to the chat and highlight the matching message

​

Date-Grouped History

Conversations are automatically grouped into time-based sections: Each group can be collapsed/expanded, and the collapsed state persists across sessions via localStorage.

​

Pinning & Drag-and-Drop Reordering

• Pin conversations to the top of the sidebar for quick access
• Drag-and-drop pinned items to reorder them using DnD-Kit SortableContext
• Use keyboard shortcuts (number keys) to quickly jump to pinned conversations

​

Batch Operations

Enter batch mode to select multiple conversations at once:

1. Toggle batch mode from the sidebar header
2. Select/deselect individual chats or use “Select All”
3. Batch export: Click “Export” on selected chats, choose a format (Markdown / JSON / HTML), and all conversations are packaged into a ZIP download
4. Batch delete: Deleted items go to the Trash (soft delete with recovery)

​

Batch Export Features

​

Export Conversations

Right-click any conversation to export in four formats:

• Markdown — Clean .md file with message formatting
• HTML — Styled HTML page ready to share
• JSON — Structured data for programmatic use
• Copy to clipboard — Quick paste anywhere

​

Diagnostic Information in Exports

Exported files automatically include metadata for debugging and workflow reproduction:

​

Print Conversation

The right-click menu also offers a “Print” option to print or save the current conversation as PDF. Uses a hidden iframe to invoke the browser’s native print dialog, bypassing popup blockers.

​

Share Conversation

Generate a read-only public link for any conversation via the right-click menu → “Share”:

• Time-limited: Links expire after 1–30 days (configurable)
• Revocable: One-click revoke invalidates the link immediately
• Secure: HMAC-signed URLs, strict CSP headers, no scripts, X-Frame-Options DENY
• Rich rendering: Server-side Markdown rendering with syntax-highlighted code blocks, tables, and dark mode support
• Agent identity: Shows the agent name and model used in the conversation

In local/desktop mode, a fallback message guides users to export HTML instead (localhost URLs are not externally reachable).

​

Project Folders

Organize conversations into named projects with color labels:

• Move conversations between projects via the context menu
• Filter the sidebar to show only a specific project’s conversations
• Project assignments persist across sessions

​

Trash & Recovery

Accidentally deleted a conversation? The Session Trash Panel provides:

• Soft-deleted conversations are kept for recovery
• One-click restore to bring back any deleted session
• Permanent delete when you’re sure

​

Source Filtering

Filter conversations by their origin channel — Web UI, Telegram, Discord, WeChat, and 35+ other platforms.

​

Infinite Scrolling

The sidebar uses IntersectionObserver-based infinite scrolling — no pagination buttons. Conversations load automatically as you scroll down.

​

Additional Features

​

Message Edit & Resend

Edit any previous message to retry with different wording. MyrmAgent ensures full front-end and back-end consistency when you edit and resend:

1. Atomic truncation — Messages after the edited one are removed from the database before the new message is sent, so the agent never sees stale context
2. Version preservation — Regenerated responses are stored as sibling versions (is_active flag); switch between versions using the left/right arrows on any assistant message
3. Smart Regeneration — Four preset modes (Try Again, More Concise, More Detailed, More Creative) plus custom instruction. The instruction is injected into the agent’s context as [Regeneration guidance: ...], directly steering the new response
4. Complaint-Up auto-escalation — When you regenerate without a custom instruction (plain retry), the system interprets this as implicit dissatisfaction and automatically upgrades the model tier (SIMPLE→STANDARD→REASONING) for a higher-quality response — no manual model switching needed
5. Undo last turn — One click removes the last user + assistant message pair and updates the conversation state
6. Conversation forking — Fork from any message to explore an alternative path without losing the original thread. Three entry points: sidebar right-click menu, /fork slash command, and mobile action sheet. Use message_index=-1 to fork from the latest message instantly. When context usage exceeds 75%, a “Fork new topic” button appears in the context usage panel for quick topic branching. If the parent conversation has an active sandbox (git worktree), the forked child automatically resets to the original repository root — preventing file conflicts from multiple conversations sharing the same sandbox workspace

​

Mid-Stream Redirect (Busy Input)

When the agent is actively generating a response, pressing Enter sends your correction as a redirect — interrupting the current generation immediately without waiting for completion: Key benefits of redirect mode:

• Zero wasted tokens — Stops generation the moment you realize the direction is wrong (saves 200–1800 tokens per redirect)
• Context consistency — Partial AI output is preserved as an AIMessage so the LLM sees the same context you saw
• Prompt cache friendly — Preserved partial text maintains the message prefix, improving cache hit rates on the next call
• Zero learning curve — Default Enter behavior, no special key combo needed

Change the default mode in Settings → Agent → Busy Input Mode (redirect / steer / queue).

​

vs Competitor Approaches

Most competitors (e.g., Hermes Agent) use a separate /history page that duplicates sidebar functionality. MyrmAgent follows the same pattern as ChatGPT, Claude, and Gemini — sidebar-integrated history — while providing 16 additional capabilities that the separate-page approach lacks.