DeepSeek Harness Plugin

OtterMind/sqlx#sqlx-dsh

Stars ★ 1 Category Tools & Capabilities Added 2026-09-21 npm @ottermind/sqlx-dsh

SQLX database tools: list saved datasources, show or test a connection, execute SQL and open a local result page, with the sqlx CLI installed on first use.

Install

# from npm (prebuilt)

dsh plugin --profile web add @ottermind/sqlx-dsh

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

dsh plugin --profile web add github:OtterMind/sqlx#path:/integrations/dsh

Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).

README

Native SQLX tools for DeepSeek Harness. The plugin registers six defineTool tools and calls the sqlx CLI for each one, so encrypted credentials, TLS policy, worker downloads and local result pages stay CLI responsibilities.

Install

dsh plugin --profile <profile> add @ottermind/sqlx-dsh

cordis.patch.yml is declared as dsh.bundle.patch, so installing the package appends the plugin row to the profile's bundle stack; no profile file edits are needed. Remove it with dsh plugin --profile <profile> remove @ottermind/sqlx-dsh.

Requirements

  • DeepSeek Harness 0.1.5 or later.
  • @deepseek-ai/dsh-tools (peer dependency) — bundled with dsh, and the profile installer runs pnpm with autoInstallPeers: false, so nothing extra is installed.
  • The sqlx CLI 0.1.11 or later. The plugin looks for SQLX_BIN, then sqlx on PATH, then the official user-level installation (~/.local/bin/sqlx, %LOCALAPPDATA%\Programs\SQLX\sqlx.exe, or SQLX_INSTALL_DIR), and when none of them exists it installs the CLI itself with npx -y @ottermind/sqlx@latest --target dsh. Adding the plugin is therefore the only setup step.

Tools

Tool Purpose May modify data
sqlx_datasource_list List saved datasources (no secrets) no
sqlx_datasource_show Show one datasource by UUID or unique name no
sqlx_datasource_test Test connectivity; executes no SQL no
sqlx_sql_execute Execute statements, return the full structured result yes
sqlx_sql_view Execute once, return a local result-page URL yes
sqlx_prefetch Download mysql, postgres, oracle, sqlserver, ui, skill or all downloads only

The two execution tools describe the authorization rule themselves: run them only after the user authorized that exact operation and scope. Results are never replayed automatically.

Credentials

Save credentials in the SQLX data directory (sqlx datasource add --connection-stdin, or the local sqlx ui page). A datasource created with --username-env/--password-env reads environment variables at execution time, and a harness started from a GUI usually cannot see your shell environment.

Links

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.