DeepSeek Harness Plugin

DeepSeek Harness Desktop に Busabase Plugin をインストールし、管理対象ローカル、既存サーバー、Cloud モードを選択します。

DeepSeek Harness Desktop に @busabase/dsh-plugin をインストールすると、DeepSeek Harness を Busabase Cloud または端末上の Busabase に接続できます。

初回起動前に選択

管理対象ローカルは設定不要の既定値です。Desktop などが Busabase プロセスを管理している場合は既存サーバーを、ホスト型 workspace や複数端末では Cloud を選択します。

1. Desktop に Plugin をインストール

DeepSeek Harness Desktop を開きます。
Plugin 名 @busabase/dsh-plugin をコピーします。
Add plugin を開き、名前を貼り付けて Official npm registry を選択します。
Install をクリックします。

インストール済みの Plugin は自動更新されません。後で更新する場合は、Desktop で Plugin をアンインストールしてから @busabase/dsh-plugin を再インストールしてください。

2. サーバーモードを選択

管理対象ローカル：Plugin が Busabase を管理

アカウント不要のセットアップと端末上のプライベートデータには管理対象ローカルを選択します。追加設定は不要です。Plugin は既定で http://localhost:15419 に接続し、必要なときに Busabase を起動するか、そのアドレスの正常なサーバーを再利用します。

Busabase Desktop などが Busabase をすでに内蔵または実行している場合に選択します。Plugin が実際に使用している profile で、baseUrl を loopback アドレスに、server.mode を external に設定します。下記のファイルパスと例は CLI の web profile 専用です。Desktop が同じ profile やパスを使うとは限りません。サーバーを先に起動してください。Plugin はそのアドレスを確認するだけで、プロセスを起動または停止しません。baseUrl は localhost、127.0.0.1、::1 のいずれかにします。非 loopback アドレスは remote OAuth モードになります。

Cloud：ホスト型の共有 workspace

Busabase アカウント、チームでの共同作業、複数端末からのアクセスには Cloud を選択します。baseUrl を https://busabase.com に設定し、DeepSeek Harness を再起動して、ブラウザーの OAuth 承認を一度行います。DeepSeek Harness が OAuth grant を credential store に保存し、次回から再利用します。変更の審査は、各 Change Request に含まれる正規リンクから Busabase Cloud 上で行います。

3. DeepSeek Harness を再起動

Plugin のインストールや設定変更の後は、DeepSeek Harness Desktop を再起動してください。Plugin や設定の変更は、実行中のセッションには反映されません。

選択した接続によって次の動作が異なります。

管理対象ローカル： 最初の busabase_start 呼び出しまで Busabase は停止しています。
既存サーバー： Busabase を先に起動します。busabase_start はサーバーを確認して MCP tools を再接続しますが、プロセスは起動しません。利用できない場合は設定されたアドレスを報告します。
Cloud： Busabase のログインと同意画面が既定ブラウザーで開きます。承認後、Cloud MCP tools が自動的に登録されます。Cloud モードに busabase_start はありません。

4. 選択した接続を確認

Desktop の Plugin 一覧で、@busabase/dsh-plugin がインストール済みかつ有効と表示されていることを確認します。

どちらのローカルモードでも次を試します。

まず busabase_start を呼び出し、Busabase の Base を一覧して内容を要約してください。

Cloud モードではブラウザー認証後に次を試します。

まず auth_verify を呼び出し、Busabase workspace のトップレベルを一覧してください。

すべてのモードで、Agent は承認済みデータを読み、書き込みを Change Request として提案できます。両ローカルモードでは Harness セッション内で preview と review が可能です。Cloud では Change Request に含まれる正規の Busabase link から Cloud 上で review と merge を行います。

Agent 接続の権限上限は changeRequest です。Agent が自分の提案を承認・merge することはできません。

CLI を利用する場合

DeepSeek Harness には CLI（dsh）もあり、Desktop の代わりに、または併用して使う構成もあります。以下のコマンドは CLI 専用で、Desktop の UI の内容を説明するものではありません。

準備

Node.js >=24.18.0
pnpm command を利用可能にする

インストール・更新・削除

# インストール
npx @deepseek-ai/dsh plugin --profile web add @busabase/dsh-plugin

# 更新
npx @deepseek-ai/dsh plugin --profile web update @busabase/dsh-plugin

# 削除
npx @deepseek-ai/dsh plugin --profile web remove @busabase/dsh-plugin

これらのコマンドは web profile を対象にします。どのコマンドの後も profile を再起動してください。Bundle の追加・更新・削除は、実行中の profile には反映されません。

既存サーバーまたは Cloud 接続の設定

$DSH_HOME/profiles/web/cordis.patch.yml を作成または編集します。DSH_HOME が未設定の場合は ~/.dsh/profiles/web/cordis.patch.yml です。

既存サーバー：

- id: busabase
  config:
    baseUrl: http://127.0.0.1:15419
    serverName: busabase
    server:
      mode: external

Cloud：

- id: busabase
  config:
    baseUrl: https://busabase.com
    serverName: busabase

ファイルに他の項目がある場合は、ファイル全体を置き換えずに追記してください。Profile override は対象 Plugin の config 全体を置き換えるため、必要な他の非既定 Busabase 設定も同じブロックに残します。このファイルに password や token を書かないでください。

CLI から起動して確認

npx @deepseek-ai/dsh --profile web

Browser が自動で開かない場合は http://127.0.0.1:3080 を開きます。

npx @deepseek-ai/dsh plugin --profile web list --depth=0
npx @deepseek-ai/dsh --profile web --dump-config

最初の出力に @busabase/dsh-plugin が含まれる必要があります。busabase row に選択した baseUrl が表示され、既存サーバーモードでは server の下に mode: external も表示されます。

旧 CLI インストールを復旧する

旧リリースは preinstall スクリプトの build approval が必要でした。ERR_PNPM_IGNORED_BUILDS が出たら現在のリリースに更新して add を再実行します。現在の package は build approval 不要です。再起動後、両方の確認コマンドを再実行してください。

npx @deepseek-ai/dsh plugin --profile web update @busabase/dsh-plugin
npx @deepseek-ai/dsh plugin --profile web add @busabase/dsh-plugin

CLI を管理対象ローカルに戻す

Busabase override を削除するか、次の設定に置き換えて profile を再起動します。server.mode: external は残さないでください。

- id: busabase
  config:
    baseUrl: http://localhost:15419
    serverName: busabase

既存の Cloud credentials は DSH credential store に残り、ローカル workspace にはコピーされません。

インストールに失敗した場合

Cloud のサインイン画面が開かない場合は、terminal（CLI）または Desktop の Plugin ログで認証 URL を確認してください。最初の OAuth callback は DeepSeek Harness を実行している同じコンピューターに到達する必要があります。Remote または headless 環境では loopback port forwarding が必要になる場合があります。

既存サーバーモードで Busabase が利用できないと表示された場合は、host と port を確認し、プロセスを管理するアプリを起動してから busabase_start を再度呼び出します。external モードでは管理対象プロセスへ自動的に切り替わりません。

Busabase DeepSeek Harness Plugin source