Repolode
Submit
T-Auto

T-Auto/dsh-ops

A plugin for the DSH agent harness that adds token-efficient ops tools for file handling, bash and structured results.

View on GitHub
Stars
3,629
Forks
101
Open issues
45
Last commit
2 hours ago

What is it?

dsh-ops is a plugin for DSH, a coding-agent harness, aimed at lowering token usage and task execution time. It adds a family of ops tools and selectively hides some of DSH's built-in tools, with a low-intrusion design intended to coexist with other plugins.

In Native mode, the tools return compact output with line numbers and clearer error feedback to reduce retry loops and the number of calls. The plugin uses DSH's tools_addition mechanism for dynamic tool loading, so advanced capabilities such as reading PDF and Word files or batch-editing many files are loaded on demand rather than inflating the system prompt. In PTC mode, it provides tools that return structured JSON, and its SDK includes 18 APIs covering 15 file and document tools plus batching, result references and a loader.

On Windows, it can provide a bash tool that mirrors DSH's native bash behavior and optionally disable PowerShell. Installation is handled through npm with profiles for the desktop, web and TUI versions of DSH.

Key features

  • 01Adds ops tools with compact, line-numbered output and clearer error messages.
  • 02Loads advanced file tools such as PDF and Word readers on demand via tools_addition.
  • 03Provides structured JSON tools for PTC mode, with an SDK of 18 APIs.
  • 04Offers a bash tool on Windows that matches DSH's native bash behavior.
  • 05Installs through npm with profiles for desktop, web and TUI.

Use cases

  • Reducing token cost when an agent works on documents such as PDFs or Word files.
  • Batch-modifying many files in one operation instead of many separate calls.
  • Running a DSH agent on Windows with a consistent bash environment.

Quick start

  1. 1

    Make sure the DSH app or DSH CLI is installed and initialized

  2. 2

    Install with the one-click npm command, choosing a profile (desktop shown; web and tui are also available)

    npx --yes dsh-ops@latest install --profile desktop
  3. 3

    Or add the plugin with the official DSH CLI (web profile shown)

    dsh plugin --profile web add dsh-ops
  4. 4

    Or enter the npm package name dsh-ops in the DSH plugin marketplace and enable it

Things to know

  • It is a plugin that requires the DSH agent harness to be installed and set up.
  • The Windows bash payload includes GPL-2.0 components under separate licenses.
  • The license metadata is listed as NOASSERTION, so the license should be checked before use.

Topics

#ai-agent#token-efficiency#plugin#developer-tools#file-operations#bash#dsh#dsh-plugin#dsh-plugins

FAQ

What is dsh-ops?
A plugin for the DSH agent harness that adds token-efficient ops tools for file handling, bash and structured results. dsh-ops is a plugin for DSH, a coding-agent harness, aimed at lowering token usage and task execution time. It adds a family of ops tools and selectively hides some of DSH's built-in tools, with a low-intrusion design intended to coexist with other plugins.
Is dsh-ops free to use? What license does it have?
dsh-ops is open source under the Other license. Check the license terms before using it in commercial products.
Is dsh-ops still maintained?
Actively maintained. The last commit to dsh-ops was on Oct 21, 2026.
What can I use dsh-ops for?
Reducing token cost when an agent works on documents such as PDFs or Word files. Batch-modifying many files in one operation instead of many separate calls. Running a DSH agent on Windows with a consistent bash environment.
How do I install dsh-ops?
Make sure the DSH app or DSH CLI is installed and initialized Install with the one-click npm command, choosing a profile (desktop shown; web and tui are also available): npx --yes dsh-ops@latest install --profile desktop Or add the plugin with the official DSH CLI (web profile shown): dsh plugin --profile web add dsh-ops Or enter the npm package name dsh-ops in the DSH plugin marketplace and enable it
Where can I get dsh-ops?
The source code and installation instructions are on GitHub: https://github.com/T-Auto/dsh-ops

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects