OpenAdviser

OpenAdviser lets local AI agents ask web AI products like ChatGPT and Grok through your logged-in browser session.

It is built for agents that need a second opinion, current web-facing research, or a strategy review without using provider APIs, CDP, or taking over the user's main browser tab.

What It Does

OpenAdviser gives your local tools a small HTTP bridge and a Chrome extension:

• send opens a new provider tab in a small OpenAdviser worker window and submits a prompt.
• read returns the current answer snapshot for that run.
• wait polls read until the answer is complete or a timeout is reached. It uses full-read mode by default.

This atomic design keeps judgement with the caller. The bridge does not guess how long a difficult answer should take.

Supported providers:

Provider	URL
chatgpt	https://chatgpt.com/
grok	https://grok.com/

Provider guidance for agents:

• Use chatgpt for deep web research, online best-practice discovery, broad source gathering, and using web information to solve engineering/product/design problems.
• Use grok when the task specifically needs current posts from X/Twitter.

Runtime Requirements

OpenAdviser does not use provider APIs. It relies on your running Chrome session.

Before calling send, read, or wait, make sure:

• Chrome is open.
• The OpenAdviser extension is loaded and enabled.
• The selected provider tab can reach the network normally.
• You are logged in to the selected provider, such as ChatGPT or Grok.
• The OpenAdviser worker window is not minimized or fully covered. ChatGPT and Grok can stall or render partial answers when their tab is hidden.

If Chrome is not running, openadviser send, openadviser read, and openadviser wait fail fast with a message asking the user to open Chrome. If the provider website is offline, blocked, logged out, hidden, minimized, or stuck behind verification, the agent should stop and ask the human operator to restore Chrome/network/provider access before retrying.

OpenAdviser intentionally uses a visible worker window instead of an ordinary background tab. Long ChatGPT/Grok answers may not start, continue, or fully render in a hidden tab even when Chrome Memory Saver is disabled. The worker tab is active in its own window so the provider page stays on the normal visible-page rendering path while the user keeps working in another window.

By default, the worker window is a small 300x220 popup placed at the bottom-right of the primary screen's available work area, leaving a margin above the Windows taskbar or equivalent system shelf.

read always re-activates the run's worker window before extracting text. wait does the same on every polling cycle because it is implemented as repeated reads. When the worker window is not in the foreground, the extension uses drawAttention to flash the taskbar, signaling the user to switch to Chrome so the provider can continue rendering. This avoids aggressively stealing focus from the user's current application.

Installation

Human Operator Setup

Use this path when a human is preparing a machine for agents. The human installs the runtime, loads the browser extension, and logs in to provider websites; the agent is still the intended user of OpenAdviser.

1. Install the CLI.

npm install -g openadviser

2. Install the OpenAdviser skill globally with the skills CLI.

npx skills add ChasePassion/OpenAdviser --global --all

This follows the OpenCLI-style skills workflow: the skill lives in skills/openadviser/ in this repo, and the installer creates a global symlink unless you choose a copy-based install.

3. Start the local bridge server.

openadviser server

4. Load the Chrome extension.

openadviser extension-path

Open chrome://extensions/, enable Developer mode, click Load unpacked, and select the directory printed by openadviser extension-path.

5. Make sure you are logged in to the web providers you want to use.

• ChatGPT: https://chatgpt.com/
• Grok: https://grok.com/

6. Check the bridge.

openadviser health

7. Run a smoke test for the agent runtime.

openadviser send "Reply with exactly OK" --provider chatgpt --text
openadviser wait --run-id <runId> --text

For Grok:

openadviser send "Reply with exactly OK-grok-provider" --provider grok --text
openadviser wait --run-id <runId> --text

Agent Self-Setup

Use this path when an AI agent is allowed to install its own local dependencies.

npm install -g openadviser
npx skills add ChasePassion/OpenAdviser --global --all
openadviser health

If openadviser health fails, start the bridge:

openadviser server

If provider login or extension loading is not already complete, ask the human operator to:

1. Run openadviser extension-path
2. Load that directory in chrome://extensions/
3. Log in to https://chatgpt.com/ and/or https://grok.com/

Agent Usage

Start by assuming the user has installed the CLI, installed the openadviser skill globally, started the bridge, loaded the extension, and logged in to the selected provider. Then call OpenAdviser as an external adviser.

Do not treat bridge health as proof that provider automation is ready. openadviser health only checks the local bridge. If send or read reports that Chrome is not running, or provider access appears unhealthy, ask the human operator to open Chrome, keep the network healthy, enable the extension, keep the OpenAdviser worker window visible, and verify provider login.

While waiting for long answers, prefer openadviser wait over ad hoc sleeps. wait periodically re-activates the worker window and flashes the taskbar to prompt the user to give Chrome foreground, which keeps ChatGPT/Grok rendering.

When this skill is available, read skills/openadviser/SKILL.md and use its scripts/openadviser.js wrapper. The wrapper builds the adviser prompt, validates context quality, starts the bridge if needed, sends the prompt, reads answer snapshots, and waits for completion when requested.

run_id="$(openadviser send "$PROMPT" --provider chatgpt --text)"
openadviser read --run-id "$run_id" --text

For longer answers, start wait in a background terminal/session and continue non-dependent work while the provider responds.

run_id="$(openadviser send "$PROMPT" --provider grok --text)"
openadviser wait --run-id "$run_id" --provider grok --text > adviser-result.txt &

Use read manually when the agent wants a single snapshot and will decide itself whether to wait longer.

When the adviser needs to reason about local implementation details, include only the directly relevant code evidence. Web providers cannot read local paths, so paths alone are not enough for code-level decisions. Use explicit excerpts rather than repository dumps:

node skills/openadviser/scripts/openadviser.js send "Review this implementation choice" \
  --context-file adviser-context.md \
  --include-file src/background.js#L204-L260 \
  --include-file src/content/chatgpt-page.js#L120-L210

The skill wrapper appends a Relevant Code Evidence section for those caller-selected excerpts. Do not include unrelated files, generated output, vendored dependencies, secrets, or large logs.

Use read --full when a provider page has only mounted part of a long answer in the DOM:

openadviser read --run-id "$run_id" --full --text

Full-read mode first scrolls the answer area to trigger lazy rendering. If the answer is complete and the provider exposes a Copy response button, the extension clicks that button inside the page and intercepts the copied text before it reaches the system clipboard. This gives the agent the provider's own full response text without requiring manual copy/paste.

Recommended prompt shape for agents:

You are an external adviser.

First analyze the task from several angles and inspect the structure of the problem.
Then use web research where useful to support your judgement.

Context:
<compact, factual context from the calling agent>

Question:
<specific decision, research request, or review request>

Keep context factual. Separate known facts, assumptions, your current judgement, and the decision you want the web adviser to help with.

Skill Layout

skills/openadviser/
├── SKILL.md
├── references/
│   ├── adviser-strategy.md
│   └── context-brief-method.md
└── scripts/openadviser.js

The skill name is openadviser.

Install it globally:

npx skills add ChasePassion/OpenAdviser --global --all

CLI

openadviser server
openadviser health
openadviser send "your prompt" --provider chatgpt
openadviser send "your prompt" --provider grok
openadviser read --run-id <runId>
openadviser wait --run-id <runId>
openadviser extension-path

Useful flags:

• --provider <chatgpt|grok>: provider to open. Default chatgpt.
• --url <url>: override the provider URL for a send.
• --timeout <ms>: CLI timeout. For wait, this is the total wait timeout.
• --interval <ms>: poll interval for wait.
• --page-load-timeout <ms>: soft page-load wait before injection continues.
• --input-timeout <ms>: provider composer wait timeout.
• --read-timeout <ms>: provider page read timeout.
• --read-task-timeout <ms>: per-read bridge task timeout for wait.
• --full: hydrate rendered content and use the provider Copy response button before DOM fallback.
• --no-full: disable wait's default full-read mode.
• --copy-button: try the provider's Copy response button during read.
• --text: for send, print only the runId; for read and wait, print only answer text.
• --quiet: suppress progress messages.

Environment variables:

• WEB_AI_BRIDGE_URL: bridge URL. Default http://127.0.0.1:8787.
• WEB_AI_PROVIDER: default provider. Default chatgpt.

Install From Source

git clone https://github.com/ChasePassion/OpenAdviser.git
cd OpenAdviser
npm install
npm run check
npm run package:extension

The extension zip is written to:

dist/openadviser-extension-<version>.zip

For local development, load the repository root directly in chrome://extensions/.

Architecture

bin/openadviser.js            npm CLI entry
bridge/client.js              provider-aware CLI implementation
bridge/server.js              local provider-aware task queue
src/background.js             extension task runner, provider registry, and worker window manager
src/content/provider.js       generic isolated-world bridge
src/content/chatgpt-page.js   ChatGPT page automation provider
src/content/grok-page.js      Grok page automation provider
manifest.json                 Chrome MV3 extension manifest
scripts/package-extension.js  extension zip packager

Boundary rules:

• The HTTP bridge does not know provider DOM details.
• The service worker owns provider defaults and visible worker window creation.
• Page automation is provider-specific.
• Adding a provider should only require a provider registry entry, manifest host permission, and a page automation script.
• The local bridge listens on 127.0.0.1 by default. Do not expose it to a LAN or the public internet.

Extension Distribution

Download the latest extension zip from the GitHub Releases page.

To build it yourself:

npm run package:extension

Then load the generated zip contents through:

chrome://extensions/ -> Developer mode -> Load unpacked

Security Notes

• OpenAdviser uses the user's existing browser login state for supported providers.
• The local bridge is intentionally bound to 127.0.0.1.
• Do not put secrets, API keys, cookies, or private transcripts into prompts unless you intentionally want the selected provider to see them.
• The extension does not close provider tabs automatically; runs are represented by their tab id and runId.

License

MIT