jackwener--opencli/extension/README.md

OpenCLI Browser Bridge Extension

The extension connects Chrome tabs to the local OpenCLI daemon. It uses Chrome extension APIs only as a transport and browser-control layer for explicit CLI commands.

Permission Notes

• debugger: sends CDP commands to OpenCLI-controlled or bound tabs.
• tabs / tabGroups: manages the dedicated OpenCLI automation container and reports selected tab metadata back to the CLI.
• cookies: reads cookies for browser-backed adapters that need authenticated fetches.
• downloads: surfaces download lifecycle to opencli browser wait download. The extension observes started / in-progress / completed / failed downloads so the CLI can wait for a file triggered by an automation command. OpenCLI filters by the command's filename/URL pattern and timeout, and does not modify, redirect, or persist browser download history.

Suggested Chrome Web Store justification for downloads:

This extension uses chrome.downloads to surface download lifecycle (started / in-progress / completed / failed) to the OpenCLI command-line tool, so agents can wait for downloads triggered during an automation workflow. The command filters by a user-provided filename or URL pattern and timeout. We do not modify, redirect, or persist user download history.