@goodandready/dsh-session-search

Configuration

Configure maxResults in your profile configuration:

# dsh configuration
plugins:
  dsh-session-search:
    maxResults: 20

Option	Type	Default	Description
maxResults	number	20	Default upper bound on returned search matches per call.

---

Tool Specification: session_search

Parameters

• query (string, required): Search query text (search terms and keywords).
• limit (integer, optional): Maximum number of matching sessions to return (automatically clamped between 1 and 100, defaults to configured maxResults).

Output Format

The tool returns a clean, plain-text representation:

• Session Title [session-id-12345]
  Context snippet with matching keywords highlighted around occurrence...
• Second Session [session-id-67890]
  Another snippet from past conversation...
(more results available — refine your query)

If no conversations match:

session_search: no matches found.

If backend execution fails:

session_search: error: 

---

License

MIT © 2026 GoodAndReady