tabbit-browser for DeepSeek Harness

English | [简体中文](README.zh-CN.md)


A plugin for DeepSeek Harness (DSH) that gives the agent control over your Tabbit Browser: real pages, real login state, and real interactions, driven through tabbit-cli — the task-isolated Playwright CLI owned by the browser itself. Use it for web automation, information extraction, QA, and benchmarks.

What you get

Installation

1. Check or install DeepSeek Harness

Check whether DSH is already installed:

dsh --version

If the command prints a version number, continue to the next step. If it is not found, install it for your operating system.

#### macOS

Install Node.js 20 or newer, then install DSH:

brew install node
npm install -g @deepseek-ai/dsh

#### Windows

Install Node.js LTS in PowerShell:

winget install OpenJS.NodeJS.LTS

Reopen PowerShell after the installation, then install DSH:

npm install -g @deepseek-ai/dsh

Run dsh --version again to confirm DSH works.

2. Install the tabbit-browser plugin

dsh plugin --profile web add github:Tabbit-Browser/dsh-plugin

3. Start DSH

dsh web

How it works

After installation, the bundle automatically registers its skill provider. The model loads the skill via skill({ name: "tabbit-browser" }) or /tabbit-browser. Before the first browser operation in a task, the skill calls tabbit_browser_install:

• ready — a stable Tabbit edition at 1.9.0 or newer is installed and the runtime is running; the agent continues with the tabbit-cli workflow.
• restart-required — the installed version is sufficient, but the tabbit-cli runtime is not running; the user is asked to restart Tabbit Browser once.
• background — no stable edition is installed, or none reaches 1.9.0; the tool starts a DSH background job that reads the operating system's configured region (macOS reads the system locale, Windows calls the system region API) and downloads the matching stable installer: the domestic build from tabbit.com for mainland China, or the international build from tabbit.ai for every other or unknown region. It selects the right Windows x64, macOS Apple Silicon, or macOS Intel package, saves it to the user's Downloads folder, reports download progress, and notifies the absolute installer path on completion.

The environment check also:

• Treats the runtime as available when multiple Tabbit instances are running; the agent sets TABBIT_PLAYWRIGHT_INSTANCE from the CLI's hint instead of reporting the instance ambiguity as an unavailable runtime.
• Diagnoses the DSH sandbox mode required to invoke the CLI on the current platform: Windows reports cliSandboxMode: danger-full-access, other platforms report default.
• Caches a successful environment check per agent session and re-checks only after a Runtime/launcher failure or an installation change, via refresh: true.

Requirements

• A stable Tabbit Browser at version 1.9.0 or newer: either the international Tabbit or the domestic Tabbit Browser — installing either one is enough. If it is missing or outdated, the plugin downloads the installer for you.
• The current DSH profile provides ctx.skills, ctx.tools, and ctx.jobs together with the corresponding model tools.
• dsh-tool-jobs provides background job control and completion notifications for the current agent.
• The current DSH profile provides a Bash/Shell tool running on the same host machine as Tabbit Browser.
• The shell's execution environment can reach the Browser-owned Runtime Service.
• On Windows, DSH's read-only and workspace-write restricted tokens cannot write to the Runtime named pipe. The skill first runs the normal tabbit-cli tasks connection probe and requests no permission at all when it succeeds. Only when the Browser, launcher, and Runtime processes are all detected but the connection returns BROWSER_RUNTIME_UNAVAILABLE does it ask the user to switch the current DSH session to Full Permission — and it then stops the task immediately, without retrying or continuing browser operations.

Notes and limitations

• Mainland China uses the domestic tabbit.com download source; all other regions use the international tabbit.ai source.
• The background download reports progress and notifies the absolute installer path when it finishes. It never opens the .dmg/.exe automatically.
• Development builds are not detected.
• The plugin does not provide native browser tools such as tabbit_browser_evaluate.
• If DSH's Bash runs in a sandbox such as E2B or a remote container that cannot access the local GUI browser, this skill cannot make Tabbit automation work there.

Development

npm test
npm pack --dry-run

License

MIT