SESSIONS & CONTROL

Let an agent use a tab in your own browser

Some sites turn away a browser that runs on a server, and some pages are already open on your laptop. Tallylamp 0.6.1 and newer can hand an agent a tab in your own Chromium browser instead. You choose each tab, and one click takes it back.

Tallylamp guides5 min readUpdated

Link your browser once

  1. Install the extension

    Download tallylamp-link.zip from the latest Tallylamp release and unzip it somewhere it can stay. Chrome reads that folder every time it starts. Open chrome://extensions, turn on Developer mode, press Load unpacked and choose the tallylamp-link folder. It is not in the Chrome Web Store yet.

  2. Connect to your server

    Click the Tallylamp Link icon to open its side panel. Enter your deployment's address, such as your Railway domain, and press Connect.

  3. Approve the code

    Your dashboard opens an approval page in a new tab. Check that its code matches the panel, tick the agents that may use this browser, and press Approve and link. Any agent on this server also covers agents you connect later. If you didn't ask for a code, press Deny.

The Tallylamp dashboard's Link this browser page beside the Tallylamp Link side panel, both showing the same pairing code.
The approval page and the side panel show the same code. Nothing is linked until you approve it in the dashboard. View full size

To change which agents can use it later, open the browser in your dashboard and edit Who can use it. An agent you untick loses the browser at its next tool call. Each client you connect over OAuth is its own agent, so one app can appear more than once; the list shows when each was last used.

Share a tab, then take it back

Open the tab you want the agent to use and press Share this tab in the side panel. Chrome then shows a bar saying the extension started debugging the browser. Chrome draws that bar itself, and no extension can hide it. Tell your agent to use the linked browser.

Keep the agent on this site is ticked by default. The agent then cannot take the tab to another site, and sharing stops if the tab leaves the site for any other reason. Untick it for work that has to move between sites, such as a sign-in that passes through another domain.

Ways sharing ends
What happensResult
You press Stop sharing this tabThat tab is yours again straight away.
You press Cancel on Chrome's debugging barEvery shared tab is handed back. Nothing is shared again until you press Share.
You close the tabIt stops being shared.
Your server is unreachable for a minuteThe extension hands every tab back by itself.
You choose Revoke link in the dashboardThe extension disconnects and its token stops working. Linking again needs a new code.
Another extension puts its own frame in the pageChrome stops the share. The panel tells you why.
The tab ends up on your Tallylamp dashboardIt is handed back as the page loads.

What the agent can reach

Inside a shared tab the agent acts as you. If the tab is signed in to your email, the agent can read your email. Share a tab the way you would hand someone your unlocked laptop with one window open.

The extension blocks anything that reaches past that tab: the whole browser's cookies, your other tabs, files on your computer, where downloads are saved, and other sites' stored data. It never attaches to Chrome's own pages, to extension pages, or to your Tallylamp dashboard, where an agent signed in as you could approve its own requests. These rules run in the extension, so a misconfigured server cannot turn them off.

No agent can lend your browser to another agent or add one to its list. Only you can, from the dashboard.

Docs behind this guide

Based on Tallylamp's documented behaviour. See the source for API details and release-specific settings.

YOUR NEXT STEP

Put it to work.

Free, MIT-licensed software. You pay for your hosting.

Deploy on Railway