This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

dsh-plugin

— source: plugin_wiki.wiki_content

Install & verify

dsh plugin --profile web add dsh-tabbit

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

• 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.
• 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.
• The current DSH profile provides ctx.skills, ctx.tools, and ctx.jobs together with the corresponding model tools.

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

Must Tabbit Browser be manually installed before use?

Not required. If the system does not detect a stable version of Tabbit at 1.9.0 or higher, the plugin will automatically start a background task to download the installation package for the corresponding region and architecture to the Downloads directory, requiring the user to manually complete the final native installation.

Which operating systems are supported?

Only macOS (Apple Silicon and Intel) and Windows 64-bit are supported. Linux systems cannot obtain installation packages through this plugin, and the source code does not include detection logic for the Linux platform.

Is it necessary to separately install the tabbit-browser Skill after installing the plugin?

No, it's not required. The plugin comes with a bundled Skill (rank=600) that is automatically registered to DSH's Skill Provider via cordis.patch.yml.

Will detection results run repeatedly?

No, they won't. Each successful detection result is cached per agent session, and subsequent calls directly return cached: true. The cache only becomes invalid and triggers a re-check when Runtime/launcher fails or the browser changes, by passing refresh: true.

What happens if multiple downloads are run simultaneously within the same agent?

The plugin tracks current in-progress jobs by agent, and repeated calls will return the existing jobId with a message indicating a download is already in progress, preventing concurrent download tasks.

How to troubleshoot CLI connection failures on Windows?

The plugin itself won't actively request Full Permission. First, normally call tabbit-cli tasks for connection detection; if it returns BROWSER_RUNTIME_UNAVAILABLE and both browser and Runtime process are detected, then ask the user to switch the current DSH session to Full Permission and stop the current task without retrying.

What is the difference between installation packages downloaded by domestic and overseas users?

The plugin reads the system region: mainland CN region downloads the domestic version (Tabbit Browser) from tabbit.com, while other or unknown regions download the international version (Tabbit) from tabbit.ai. Both versions are supported, but they differ in identification name and bundleId.

How to uninstall the plugin?

Use dsh plugin --profile web remove github:Tabbit-Browser/dsh-plugin; the plugin does not modify persistent data outside the system, and the detection cache only exists in the current DSH agent session memory, automatically becoming invalid after restart.

— source: plugin_wiki.faq_json

Compatibility

• DSH: 未声明
• Node: >=20
• Platforms: macOS (Apple Silicon), macOS (Intel), Windows x64

— source: plugin_wiki.compatibility_json

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule