gitwtfhub

wtf is trim-hero?

kjmagnan1s/trim-hero — explained in plain English

Analysis updated 2026-05-18

0JavaScriptAudience · developerComplexity · 2/5Setup · easy

TL;DR

A Claude Code skill that measures what's actually in your AI request payload and lets you approve trimming the unused tool definitions and instructions that bloat it.

Mindmap

mindmap
  root((Trim Hero))
    What it does
      Profiles request payload
      Ranks bloat
      Gated trimming
    Tech stack
      Claude Code
      Node.js
      Bash
    Use cases
      Reduce token cost
      Speed up requests
      Share before/after receipt
    Audience
      Claude Code users
      Developers

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

Find out exactly what tool definitions and instructions are bloating your Claude Code requests.

REASON 2

Cut unused context from every request to reduce token cost and speed up responses.

REASON 3

Safely undo a trim using the automatic settings backup if something breaks.

REASON 4

Generate a shareable before and after image showing how much you trimmed.

What's in the stack?

JavaScriptNode.jsClaude CodeBash

How it stacks up

kjmagnan1s/trim-hero00kaku/gallery-slider-block3rd-eden/ircb.io
Stars0
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-05-192016-11-16
MaintenanceDormantDormant
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencedevelopergeneraldeveloper

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

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires Claude Code and Node.js already installed, Windows users need WSL.

Wtf does this do

Trim Hero is a tool for Claude Code, the AI coding assistant, that finds and removes wasted space in the information sent to the AI on every single request, things like tool definitions, skill lists, and instructions you never actually use. The idea is that a lot of what gets sent to the AI model behind the scenes is unnecessary clutter that costs money and slows things down without adding value, so Trim Hero measures it and helps you cut it. You install it with a single command, and it can set itself up either as a proper Claude Code plugin or, if that is not available, by copying itself into a local skills folder. Once installed, you run it inside any project by typing a single command, or by simply asking what is using up your context window. Under the hood, it works in a clear sequence of steps. First it records how much information a normal request currently sends. Then it starts a small local proxy on your own machine, sends one throwaway test request through it using a cheap AI model, and captures exactly what gets sent, without changing anything or sending your data anywhere else. It then breaks that captured request down into named sections and estimates how many tokens, the units AI models are billed by, each section costs. An AI agent then reviews each section against your actual project and suggests whether to remove it, keep it, or ask you first. Nothing is changed until you personally approve the suggested cuts, and a backup of your settings is always saved first, with a plain way to undo everything if needed. After a trim, the tool can generate a simple shareable image showing how many tools and tokens per request you had before and after, created entirely on your own computer. The README is clear that everything stays local: the temporary file that captures your request contents is never uploaded anywhere, and the local proxy does not log your API key or login token. This tool is for existing Claude Code users who want to reduce cost and slowdown caused by unnecessary content in every request.

Yoink these prompts

Prompt 1
Install Trim Hero and run it to see what's eating my Claude Code context window.
Prompt 2
Explain how Trim Hero's local proxy captures my request payload without sending data anywhere else.
Prompt 3
Walk me through approving or rejecting Trim Hero's suggested cuts for my project.
Prompt 4
Show me how to undo a Trim Hero change using the settings backup file.

Frequently asked questions

wtf is trim-hero?

A Claude Code skill that measures what's actually in your AI request payload and lets you approve trimming the unused tool definitions and instructions that bloat it.

What language is trim-hero written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Claude Code.

How hard is trim-hero to set up?

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

Who is trim-hero for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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