At a glance

What it does

A pre-alpha DSH bundle scaffold for a planned Chrome-first, human-steerable browser runtime.

Code-evidenced contributions

What it adds to DSH

Model ToolsNative browser bundle scaffold

A declared DSH bundle for a future Chrome-first browser runtime; the current patch only mounts a scaffold and exposes no browser tools.

Mechanism evidence ↗

Before you choose it

This package declares a DSH bundle for browser-agent work with planned Chrome, CDP, accessibility-tree observation, and human handoff capabilities. At this pinned revision, it only mounts a lifecycle-safe scaffold: no model-facing browser tools are registered, so it is not a usable browser automation plugin yet.

Best for

Developers following or contributing to the early design of a DeepSeek Harness browser integration—not users who need browser automation today.

Common tasks

Inspect the pinned pre-alpha bundle and its declared DSH compatibility.
Evaluate the proposed Chrome-first browser-runtime direction before contributing.
Track the project until its promised vertical slice exposes usable browser tools.

Permissions and data

The current bundle patch only mounts a scaffold; no active browser permissions or data handling behavior is evidenced for this revision.

Permissions

No model-facing browser tools are registered in the current bundle patch.

Data handling

The README describes local-only control and use of existing signed-in Chrome sessions as planned scope, not verified current behavior.

External services

No external service integration is evidenced for the current scaffold.

Credentials

No credential requirement is evidenced for the current scaffold.

Limitations

Pre-alpha architecture and protocol phase; the project says it is not production-ready.
No browser tools are registered in this revision.
The repository says not to publish or recommend installation yet.
The future first usable slice is Chrome-only; other browsers are out of scope until later.

What DSHub checked

Pinned Git source, DSH bundle patch, Node >=22.19 requirement, Cordis peer dependency, DSH range, and web/desktop profile declarations are present.
The package metadata declares a prepack script that runs checks and tests before packing.

What DSHub did not check

Installation was not performed.
No runtime browser control, Chrome extension, permission prompt, session access, or human-handoff behavior was executed.
No npm package distribution was found for the declared version.

Pinned install

Install DSH Native Browser

This plugin bundle does not have a DSH Plugin install action. Use its source documentation for the delivery method.

Visit the source project ↗

Maintainer source

Project README

View at commit 53db628 ↗

Maintainer-authored contentCaptured from README.md on Sep 11, 2026. The text and repository-relative media are fixed to commit 53db628e3755 with content hash 9e7a82efb7ea; provider-hosted badges may update independently. README commands are upstream documentation; the DSHub copy action above is the verified, version-pinned install.

dsh-native-browser

Chrome-first browser runtime for DeepSeek Harness, designed for fast, observable, human-steerable agent browsing.

dsh-native-browser aims to let DSH agents operate the Chrome you already use: existing tabs, signed-in sessions and normal extensions, with low-latency semantic observation, reliable actions, visible handoff and safe interruption.

The target is not another thin click(x, y) wrapper. The design is a stateful browser runtime inspired by the strongest parts of Codex's Chrome integration:

a Manifest V3 Chrome extension connected to a local runtime through Native Messaging;
CDP-backed control without launching a second browser profile;
accessibility-tree-first observation with compact incremental updates;
stable element references plus actionability and hit-target checks;
explicit ownership for existing tabs, agent-created tabs and end-of-turn cleanup;
immediate human interruption and resumable handoff;
screenshots as a visual fallback, not the default source of page structure.

Project status

Pre-alpha / architecture and protocol phase. The repository currently contains a valid DSH bundle scaffold, research, architecture decisions and validation checks. It does not register browser tools yet and should not be presented as production-ready.

The first usable milestone is a Chrome-only vertical slice: connect an extension, claim or create one tab, observe its accessibility tree, navigate, click and type, then release it safely.

Scope

In scope for the first production release:

Google Chrome stable on macOS, Windows and Linux;
the user's existing Chrome profile and authenticated sessions;
DSH web and desktop profiles;
semantic browsing, screenshots, downloads, dialogs, files and multi-tab workflows;
local-only control plane with explicit permissions and auditable lifecycle events.

Out of scope until Chrome is excellent:

Edge, Chromium variants, Firefox and Safari;
hosted/remote browser farms;
CAPTCHA bypass or stealth claims;
arbitrary unrestricted CDP exposed directly to the model.

Planned architecture

flowchart LR
    A[DSH agent] --> T[Browser tool adapter]
    T --> R[Persistent browser runtime]
    R --> H[Local native host]
    H <--> E[Chrome MV3 extension]
    E <--> C[Chrome tabs via chrome.debugger / CDP]
    C --> O[AX tree + DOM + screenshot observations]
    O --> R
    U[Human using Chrome] <--> C
    U -. interrupt / handoff .-> R

The runtime keeps live browser objects and event subscriptions out of the model context. The model receives compact, typed observations and stable references; the runtime performs freshness, visibility, stability and hit-target checks immediately before actions.

Read the target architecture, Codex Chrome research, wire protocol draft and roadmap.

DSH discovery metadata

The package is structured as a DSH bundle and includes the discovery terms used by the ecosystem:

npm keywords: dsh-plugin, deepseek-harness, browser-automation, computer-use, chrome-extension;
GitHub topics: dsh-plugin, deepseek-harness, browser-automation, computer-use, browser-agent;
bundle declaration: dsh.bundle.patch in package.json;
compatibility declaration for DSH 0.1.5 release candidates and the web/desktop profiles.

Development

Prerequisites: Node.js 22.19 or newer and pnpm 11.

pnpm install
pnpm check
pnpm test
pnpm pack --dry-run

Do not publish or recommend installation yet. Once the first vertical slice is available, the intended command will be:

dsh plugin --profile web add dsh-native-browser

See CONTRIBUTING.md before opening a change. Security-sensitive findings should follow SECURITY.md, not a public issue.

Design principles

Fast paths are semantic. Use AX/DOM state for routine work and images only where pixels carry essential meaning.
Actions verify reality. Resolve targets fresh, scroll, wait for stability, hit-test, act, then observe the resulting change.
Browser state has an owner. Existing user tabs are claimed and released; agent tabs are tracked and cleaned up.
Human control wins immediately. User interaction or an extension stop action cancels in-flight work and produces a resumable state.
Capabilities are explicit. Sensitive operations are narrow, policy-gated and auditable; raw CDP is an internal transport.
Performance is measured. Latency, observation size, stale-reference rate, action success and recovery behavior are benchmark gates.