opensider

README

Give your browser AI wings

中文 | English

OpenSider is a browser extension that drives local Agents (Claude Code CLI, Copilot CLI, OpenCode CLI, Cursor CLI, and other local Agent tools) from within your browser for web information gathering, web automation, and more.

• Collaborate with Agents in the browser
  Chat with your local Agent directly in the browser side panel, without opening command line or terminal tools.

• Automatic web page context
  No need to tell the Agent which page you are viewing — the Agent automatically gets the page information loaded in your browser and can operate on it.

• Data persistence
  All session data is stored locally, so it won't be lost when the app is updated or reinstalled.

Video Demo

What it shows: chat with the Agent to distill web page information into a news digest (an HTML file), which is then opened in the browser.

https://github.com/user-attachments/assets/f0a9c654-b66e-43ef-a233-6942a30e83c6

Install & Use

1. Install

This extension is for Chromium-based browsers such as Chrome / Edge / Brave. Before installing, make sure you already have a running Agent CLI program on your machine.

One-step install: paste the prompt below into the local AI Agent you already use (Claude Code, Codex, OpenCode, Cursor, …). It will prepare your local environment and walk you through installing the browser extension.

Install the OpenSider browser extension for me.
Read https://raw.githubusercontent.com/parksben/opensider/main/skills/opensider/SKILL.md and follow its install flow.

2. Update

One-step update: when the side panel tells you a new version is available, copy the prompt below to your local Agent and let it guide you through the update.

Update the OpenSider browser extension for me.
Read https://raw.githubusercontent.com/parksben/opensider/main/skills/opensider/SKILL.md and follow its update flow.

3. Uninstall

One-step uninstall: one prompt is all it takes, and you choose whether to keep or remove your local data.

Uninstall the OpenSider browser extension for me.
Read https://raw.githubusercontent.com/parksben/opensider/main/skills/opensider/SKILL.md and follow its removal flow.

Workspace & Local Data

OpenSider never uploads your configuration or chats to any server: all sessions and Agent artifacts live on this machine under ~/.opensider, and they stay usable after uninstalling or reinstalling the extension.

File / folder	What it holds
~/.opensider/workspace/	The Agent's working directory: every tab and every session works in this same folder
~/.opensider/workspace/browser/	Scratch files produced during a session, such as the current page snapshot, interactive controls, page commands and results, screenshots
~/.opensider/workspace/outputs/	Artifacts the Agent produces during a session (tables, documents, code, …)
~/.opensider/ui-state.json	Session list, chat history and preferences
~/.opensider/runtime/	The local bridge binary, plus the Claude Code / Codex ACP adapters
~/.opensider/host.log	Bridge log — the Agent can use it to debug problems
The extension folder you picked at install (suggested ~/OpenSider/)	The folder the browser actually loads — do not move or delete it, or the extension breaks

On Windows these live under %USERPROFILE%\.opensider and %USERPROFILE%\OpenSider.