Tabs and sessions
8. Tabs and groups: where the agent works
Each conversation has its own tab group, titled “OpenCode · conversation name” and with its own color. It is that agent's workspace — it does not touch your other tabs.
Background tabs
By default the extension does not steal focus: tabs created or attached by the agent open in the background, and the window you are working in stays where it is. If you prefer to see the tabs appearing, turn on “Allow tabs opened or attached by the agent to come to the front” in the settings.
On the page where the agent is acting, an animated pastel blue border appears with the notice “OpenCode is on this tab”, a Stop button and a virtual mouse that slides to the target and shows a ripple on every click.
Connecting one of your tabs to the agent
- Connect current tab (link icon in the conversation bar): brings the active tab into the conversation's group.
- With tabs connected, the same button opens the list: “Connect a new tab” and, on each tab, “Remove … from the context”.
Removing a tab from the context does not close the tab: it just takes it out of the group, and it becomes a normal tab of yours again.
Tabs from another window cannot be attached. The extension replies: “The tab is in another window. Open a new tab from the session or move the tab to the group window before attaching it.”
The group is born when needed
If the option to create a group when starting a conversation is off (default), the group is born when the agent opens a new tab (browser_tabs_create) or when you connect a tab. Read and interaction tools do not open tabs on their own: without a tab, they fail with guidance. It is the most economical flow: no blank tabs piling up.
9. Several conversations at once
This is the extension's strong point: each conversation runs on its own, in its tab group, and you switch between them without stopping anything.
Creating a conversation
Click + (New conversation). The button works even while the current conversation is running — it is only blocked during its own creation, so a double click does not create two conversations.
The new conversation starts empty, with the model (and the agent) selected, and is already focused in the panel.
Switching conversations
Use the “OpenCode sessions” picker. Each item shows the conversation name and a suffix:
- “ · running” — that conversation is running;
- “ · new reply” — something new arrived while you were in another one.
Choosing the conversation clears the news notice.
Following the focused tab group
With “Show the conversation of the focused tab group in the panel” on (default), just click a tab in a group: the panel switches to that group's conversation. The switch has a small delay (150 ms) so it does not flicker when you pass through several tabs.
Creating or selecting a conversation manually cancels this automatic switch — the panel will not “go back on its own” to another conversation right after your click.
Creating the group together with the conversation (optional)
Turning on “Create a tab group when starting a new conversation”, the + already opens a blank tab (in the background, in the panel's window) and the group named after the conversation. It is useful when you want to see each conversation's “anchor” in the tab bar from the start; the cost is one blank tab per conversation.
Off (default), the group is born when the agent opens a new tab or when a tab is attached.
Deleting a conversation
Use the trash can (Delete session). The confirmation says: “Delete this session? The history will be removed from OpenCode.”
When deleting:
- the history leaves OpenCode;
- the group is released: blank tabs are closed and real pages are only ungrouped (nothing of yours is closed);
- if it was the conversation on screen, the most recent one is shown instead.
Limits
- The panel keeps detailed state for up to 4 conversations. The others still exist in OpenCode and reload when you open them.
- The conversation↔group bond lives in the browser session: closing Chrome completely breaks the bond (the tabs stay there, without an owner).
- The panel is a single view: two open windows show the same conversation.