dsh-desktop-browser

@deepseek-ai/dsh-desktop-browser

Opens the dsh Web UI in a browser window with no address bar, giving it a native-app feel.

Features

• Auto browser detection — finds Chrome, Edge, Chromium, or Safari on Windows/macOS/Linux
• Address bar hidden — uses Chromium's --app=<url> flag
• Auto URL resolution — reads host/port from the webserver
• Window geometry — configurable size and position (auto-center supported)
• Automatic cleanup — closes browser when dsh shuts down

Installation

dsh plugin --profile web add Mby159/dsh-desktop-browser

Then start dsh:

dsh web

The plugin's cordis.patch.yml is merged automatically — no manual configuration editing required.

Verifying the installation

After dsh plugin add completes, verify the plugin is active before starting dsh web:

dsh --profile web --dump-config | grep desktop-browser

If the plugin was successfully added to the bundles list, the output includes desktop-browser in the config tree.

If the grep finds nothing, the plugin package was installed but the bundles list was not updated. Fix it manually:

# Read the profile's package.json
# Add "@deepseek-ai/dsh-desktop-browser" to the dsh.profile.bundles array if it is missing
# Then re-verify:
dsh --profile web --dump-config | grep desktop-browser

When the browser doesn't open

If dsh web starts but no browser window appears:

1. Check the dsh startup logs for [desktopBrowser]. If you see:

   [desktop-browser] bundle not found in profile bundles
   

   → The plugin is not in the bundles list. Apply the fix above.

2. If the logs show no desktop-browser entries at all, the plugin was not loaded. Verify with:

   dsh --profile web --dump-config | grep desktop-browser
   

Requirements

• A Chromium-based browser (Chrome, Edge, Chromium) or Safari
• DeepSeek Harness web profile
• pnpm ≥10: if installing from GitHub and pnpm reports a blocked prepare script, add the key it prints to ~/.dsh/profiles/web/pnpm-workspace.yaml under allowBuilds, then re-run the install command above

How it works

The plugin is a Cordis bundle. dsh plugin add installs the package and adds it to your profile's dsh.profile.bundles list, so the plugin's cordis.patch.yml is loaded automatically on every dsh web startup.

Configuration (optional)

The plugin works with zero config. To override defaults, create or edit ~/.dsh/profiles/web/cordis.patch.yml with your overrides:

- id: desktop-browser
  config:
    width: 1400
    height: 900
    positionX: auto
    positionY: auto
    disableExtensions: true
    openDelayMs: 500
    minimize: false

Field	Type	Default	Description
url	string	auto	Override the URL to open
browser	string	auto-detect	Explicit browser path
width	number	1400	Window width in pixels
height	number	900	Window height in pixels
positionX	number | 'auto'	'auto'	Window X position
positionY	number | 'auto'	'auto'	Window Y position
disableExtensions	boolean	true	Pass --disable-extensions
openDelayMs	number	500	Delay before opening after server start
minimize	boolean	false	Start browser minimized

API

The plugin registers ctx.desktopBrowser:

• url — the resolved URL
• running — whether the browser is open
• open() — open the browser window
• close() — close the browser window