gitwtfhub

wtf is claude-squelch?

rongtnt/claude-squelch — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

A hook for Claude Code that trims noisy terminal output like test runs and installs down to the useful parts, cutting token usage by 70 to 95 percent.

Mindmap

mindmap
  root((squelch))
    What it does
      Compacts noisy output
      Preserves errors always
      Passes unknown output through
    Tech stack
      Python
      Claude Code hooks
    Use cases
      Save AI context space
      Speed up test feedback
      Filter build and install logs
    Audience
      AI coding tool users
      Developers using Claude Code

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Shrink noisy pytest, jest, or cargo test output so an AI coding assistant sees only the failures.

REASON 2

Cut token usage on npm or pip install logs when working with Claude Code.

REASON 3

Compact git status, log, and diff output before it fills up the AI's context.

REASON 4

Add a safety net that never hides errors, warnings, or unrecognized command output.

What's in the stack?

Python

How it stacks up

rongtnt/claude-squelch0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultyeasyhardhard
Complexity2/54/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

No dependencies, installs via plugin marketplace or a short settings.json edit.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

Squelch is a small tool that trims down noisy command output before it reaches Claude Code, an AI coding assistant. When you run something like a test suite or a package install, the terminal often prints thousands of lines, most of which are just passing tests or progress messages. Squelch catches that output and shrinks it down to the useful parts before the AI ever sees it, which saves a large amount of the context space the AI has available to think. It works as a hook that plugs into Claude Code's own hook system. When a command like pytest or npm install finishes running, squelch looks at what kind of command it was and, if it recognizes the pattern, rewrites the output to keep failures, warnings, and summaries while dropping the repetitive lines that show everything passed. According to the project's own benchmarks, this can cut token usage for noisy commands by 70 to 95 percent, while commands whose output is already mostly useful, like a linter or type checker, are left untouched. Safety is a core design goal here. The tool is built to fail toward showing too much rather than too little: errors and warnings are always kept, any command it does not recognize passes through completely unchanged, and if anything goes wrong internally it simply does nothing rather than risk hiding a real problem. Anyone can also bypass it entirely for a single command if they want the raw output. Installation takes about thirty seconds, either through Claude Code's plugin marketplace or by manually adding a couple of lines to a settings file that tells Claude Code to run the squelch script after every terminal command. The tool covers common test runners, package managers, build tools, linters, and git commands, and is written in Python with no external dependencies. It comes from a larger collection of reusable Claude Code hooks the same author maintains, and is released under the MIT license.

Yoink these prompts

Prompt 1
Explain how squelch decides what parts of a command's output to keep or drop.
Prompt 2
Walk me through installing squelch via the Claude Code plugin marketplace.
Prompt 3
Show me how to manually wire squelch into my Claude Code hooks settings file.
Prompt 4
How do I bypass squelch and see raw output for a single command?
Prompt 5
What test suite does squelch use to guarantee it never hides an error?

Frequently asked questions

wtf is claude-squelch?

A hook for Claude Code that trims noisy terminal output like test runs and installs down to the useful parts, cutting token usage by 70 to 95 percent.

What language is claude-squelch written in?

Mainly Python. The stack also includes Python.

What license does claude-squelch use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is claude-squelch to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is claude-squelch for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.