In your DSH profile directory:

pnpm add dsh-tool-headroom

Add the plugin to your cordis.patch.yml or custom agent preset:

- insert:
    - id: headroom
      name: 'dsh-tool-headroom'

Customizable via DSH Settings UI or profile YAML:

Option	Type	Default	Description
`enabled`	boolean	`true`	Enable or disable output compression globally
`thresholdBytes`	number	`3072` (3KB)	Minimum output size to trigger compression
`maxTargetBytes`	number	`12288` (12KB)	Target maximum size for compressed output
`jsonCompression`	boolean	`true`	Enable JSON SmartCrusher
`logDenoising`	boolean	`true`	Enable log deduplication and progress bar folding
`stripAnsi`	boolean	`true`	Strip terminal ANSI escape codes
`collapseRepetitions`	boolean	`true`	Collapse sequential duplicate lines
`preserveErrorContext`	number	`8`	Number of context lines to preserve around errors
`cacheRawOutput`	boolean	`true`	Cache full uncompressed output to disk (CCR)
`cacheDir`	string	`""`	Custom cache path (defaults to OS temp directory)
`excludedTools`	string[]	`["read", "read_image"]`	Tool names excluded from compression

Customizable via DSH Settings UI or profile YAML:

Option	Type	Default	Description
`enabled`	boolean	`true`	Enable or disable output compression globally
`thresholdBytes`	number	`3072` (3KB)	Minimum output size to trigger compression
`maxTargetBytes`	number	`12288` (12KB)	Target maximum size for compressed output
`jsonCompression`	boolean	`true`	Enable JSON SmartCrusher
`logDenoising`	boolean	`true`	Enable log deduplication and progress bar folding
`stripAnsi`	boolean	`true`	Strip terminal ANSI escape codes
`collapseRepetitions`	boolean	`true`	Collapse sequential duplicate lines
`preserveErrorContext`	number	`8`	Number of context lines to preserve around errors
`cacheRawOutput`	boolean	`true`	Cache full uncompressed output to disk (CCR)
`cacheDir`	string	`""`	Custom cache path (defaults to OS temp directory)
`excludedTools`	string[]	`["read", "read_image"]`	Tool names excluded from compression

Install

README