DeepSeek Harness Plugin

STARDUSTLC666/dsh-sql

Stars ★ 9 Downloads (30d) 5,605 Category Tools & Capabilities Added 2026-08-17 npm dsh-sql

Database tools for agents: list/query/exec/schema/stats/health across SQLite/MySQL/PostgreSQL, with lexer-grade read-only protection, row caps, CSV/JSON query output and an approval-gated write path.

Install

# from npm (prebuilt)

dsh plugin --profile web add dsh-sql

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

dsh plugin --profile web add github:STARDUSTLC666/dsh-sql

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

简体中文 · English

SQL

Inspect the schema, then answer questions with data.

downloads total downloads

Install · Workflow · Full guide

Features

  • Connect SQLite, MySQL or PostgreSQL.
  • Inspect schemas and summaries with row and time limits.
  • Review the database and SQL before writes, then verify by querying.

Install

Open Plugins in the DSH desktop app and install dsh-sql. If the CLI is available:

dsh plugin --profile desktop add dsh-sql

For the web profile, replace desktop with web. Restart that DSH profile after installation. The package’s DSH requirement is >=0.2.2-rc.3.

Start using it

  1. Add your SQLite, MySQL or PostgreSQL connection in plugin settings and confirm the database.
  2. Inspect the schema first, then query a small set of rows in read-only mode.
  3. Specify filters and result limits; check columns, row counts and truncation.
  4. Enable write access only when needed, review the SQL and connection before confirming, and query again to verify.

Example request:

Inspect the database schema and answer with a read-only query, stating row limits and any truncation.

Before you start

Bring your own database connection and permissions. Write permissions and host approval are separate controls.

Configuration, detailed tools and troubleshooting: full reference.

Plugin updates

Check updates at the bottom of the workbench or native plugin details. Automatic checks are on by default; automatic installation is off. You choose whether to install and when to restart. Suite-managed components update with their bundle. Update behavior.

Documentation

Feedback and contributions

If the plugin helps, a Star makes it easier for others to discover. Report problems or suggest improvements in Issues; code and documentation PRs are welcome. Include versions and reproduction steps, and remove credentials from reports.

License

MIT

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.