@wxg-prc-cpg/browser-skill-dsh-plugin

Configuration

After installing the plugin, edit your profile's cordis.patch.yml. For the web profile, the default location is ~/.dsh/profiles/web/cordis.patch.yml. If you set DSH_HOME, use $DSH_HOME/profiles/web/cordis.patch.yml instead. Replace web with your profile name as needed.

If the file contains only comments and [], keep the comments and replace [] with the YAML below. If it already contains patch entries, add this entry to the existing list or edit its existing id: browserskill entry. Keep a single top-level YAML list. This overrides the plugin registered by the installed bundle:

- id: browserskill
  config:
    bskPath: bsk
    defaultTimeoutMs: 120000
    maxSessions: 5
    observationEnabled: true
    thumbnailIntervalMs: 1500
    idleIntervalMs: 8000
    lazyTools: true

Change bskPath to the full path of your CLI binary if it is not on dsh's PATH. A patch replaces the entry's entire config object, so keep all overrides you need together in that object.

Configuration changes follow dsh.profile.patchReload in the profile's package.json: live (the default for web) applies changes when you save the patch file; startup requires restarting the profile. Restart after upgrading the plugin in either case.

All fields are optional; omitted fields use the defaults below:

Option	Default	Purpose
bskPath	bsk	Path to the CLI binary.
sessionStateDirectory	Scoped under $BSK_HOME/dsh-starts (or ~/.bsk/dsh-starts)	Durable recovery records; optionally isolate by host/profile.
defaultTimeoutMs	120000	Default command execution timeout in milliseconds; output collection after exit has a separate 2-second limit.
maxSessions	5	Maximum concurrent sessions started by this plugin.
observationEnabled	true	Enable live browser observation.
thumbnailIntervalMs	1500	Screenshot interval for active sessions, in milliseconds.
idleIntervalMs	8000	Screenshot interval for idle sessions and the recent-activity window, in milliseconds.
lazyTools	true	Reveal the browser tools when the skill is invoked. Set false to register them at startup.

With lazyTools: true, only the skill's catalog entry is initially advertised to the model. The six browser_* tool schemas are added to the system prompt after the browser-skill skill is successfully invoked, either by the model or through /browser-skill. Set lazyTools: false to make the tools available immediately.

After a plugin reload, a live or resumed conversation's successful skill invocation restores the tools from its stored history. If an older plugin reports unknown tool "browser_session", invoke skill browser-skill again, or set lazyTools: false in the profile patch as a temporary workaround.