Understanding Conversations

Conversations in Swordfish are persistent chat sessions that maintain context across multiple interactions. Understanding how they work will help you use Swordfish more effectively.

Starting a New Chat

Click the "New" button to start a fresh conversation. This:

Clears the current conversation history
Creates a new conversation associated with the current tab
Resets the Events panel (console logs, network requests)
Automatically searches for pre-read files in your project
Connects the agent to the active browser tab

Try it: New Button

Click the button to see it in action (demo only). The plus icon indicates creating a new conversation.

Note

Starting a new chat doesn't close your browser tabs - it just starts a fresh conversation context. The agent will still be able to interact with the same tab.

Reconnecting to a Tab

If you switch to a different browser tab and want to continue your conversation with that tab, use the reconnect button (the refresh icon in the tab status bar). This:

Switches the agent's focus to the new tab
Preserves your conversation history
Clears the Events panel for the new tab (to avoid confusion)
Reattaches the agent to the new tab's page context
Adds a system message indicating the tab switch

💡 Tip

Reconnecting is useful when you want to work on multiple tabs in the same conversation. For example, you might start on a login page, then reconnect to a dashboard tab to continue the same task.

Conversation Persistence

Conversations are saved automatically. This means:

If you close and reopen the extension, your conversation history is restored
Each conversation is associated with a specific tab and window
You can have different conversations for different tabs

When to Start New vs. Reconnect

Scenario	Action
Starting a completely new task	Click "New" to clear history and start fresh
Switching to a different tab for the same task	Use Reconnect to preserve context
Working on a different project	Click "New" to reset everything
Continuing work after closing/reopening extension	Your conversation is automatically restored

Tab Status

The tab status bar shows:

Tab Title - The current page title
Connection Status - Whether the agent is connected to the tab
Reconnect Button - Click to reconnect to the active tab

Try it: Tab Status Bar

Example Page - Swordfish

Click the refresh button (↻) to simulate reconnecting to a tab. The status dot will change color during the process.

If you see a disconnected status, try clicking the reconnect button or starting a new conversation.