dsh-tool-terminal-search

When terminal scrollback grows to tens of thousands of log lines, a model can only page backward one chunk at a time from the newest output, and totalLines tells it the buffer size but not where the critical error line lives. dsh-tool-terminal-search closes that gap by letting the model search by content instead of paging blindly.

terminal_search scans the entire retained buffer line by line, matching a literal substring (grep -F style) by default or a JavaScript regular expression when regex is enabled. Matches are returned newest-first, each carrying a newest-relative offset that feeds directly into a follow-up terminal_read call for context. Repeated regex patterns are served from a process-wide bounded FIFO cache so they are never recompiled. The tool composes exclusively over the public ctx.terminals.read seam, requiring no upstream package changes and running on today's published dsh releases.

If you are running long-lived backend processes under DeepSeek Harness and need to pinpoint an error line or stack trace in a massive log, or if you want content-based search capability before the native upstream implementation lands, this plugin offers a drop-in solution.