Preface

DSH can extend Agent capabilities through plugins. getnote-dsh-plugin is used to integrate GetNote Brain into DSH, allowing Agents to search, save, and read GetNote Brain notes using natural language. It is suitable for developers who need to query notes, save web links, and view knowledge bases directly within DSH.

What is this

@getnote/dsh-plugin is a DSH plugin maintained by iswalle, licensed under MIT. It integrates specific operations of GetNote Brain into DSH, enabling Agents to invoke note search, save, and view capabilities while retaining the local authentication process.

Core Features

  • Check GetNote Brain login status
  • Search all notes by natural language semantics
  • Search within a specified knowledge base
  • Save text, web links, and local images
  • Set title and tags when saving
  • View recent notes
  • View note details by ID
  • View knowledge base list
  • Provide DSH-guided Skills, allowing Agents to prioritize these native tools

Installation and Enablement

  1. Confirm that the local Node version satisfies >=20.
  2. Add the plugin:
dsh plugin --profile web add @getnote/dsh-plugin
  1. Log in to GetNote Brain:
npx @getnote/cli@latest auth login

Complete authorization following the page prompts. GetNote Brain OpenAPI requires GetNote Brain membership. Regular users do not need to manually fill in the API Key; authentication is managed locally by the GetNote CLI.

  1. Restart DSH.

Typical Usage

After restarting, you can directly instruct the Agent:

Help me search for notes about Agent Harness in GetNote Brain
Save https://example.com/article to GetNote Brain, adding the "To Read" tag
List the last 10 notes
Open note 1896830231705320746
List my knowledge bases

Update and Uninstall

Use the following commands to maintain the plugin:

dsh plugin --profile web update @getnote/dsh-plugin
dsh plugin --profile web remove @getnote/dsh-plugin

Configuration Guide

If you need to adjust the timeout or output limits, you can override them in the profile’s cordis.patch.yml:

config:
  timeoutMs: 120000
  maxOutputBytes: 10485760

binaryPath and apiUrl are only for development or debugging environments.

Security and Notes

  • The plugin only exposes specific GetNote Brain operations and does not provide entry points for arbitrary shell parameters.
  • The login status check does not write the API Key or trailing characters into the model context.
  • High-risk capabilities, such as deletion and bulk modification, are not yet available in the first version.
  • The plugin runs under the current user’s permissions; please only install from trusted sources.
  • If a more complete set of GetNote Skills is installed locally, DSH can still discover and use them normally; the plugin will not copy the same Skills or override versions.

Conclusion

getnote-dsh-plugin is suitable for using GetNote Brain as the note capability within DSH, providing clear operations such as search, save, view, and knowledge base reading.

Related addresses:

  • GitHub: https://github.com/iswalle/getnote-dsh-plugin
  • Directory page link: https://www.skillhub.cn/plugins/iswalle/getnote-dsh-plugin

DSH Plugin Directory is used for discovering third-party plugins and does not represent an official affiliation with DeepSeek / Hua Fang.