ballast

Not yet reviewed

KOZMOS Ballast: a context coach. A toast when the context window passes warnAt, then a band with an anchor and a water-level gauge at actAt: "⚓ ctx 89% —…

0 upvotes

Source: github.com/ersinkoc/claude-mods/tree/main/mods/ballast
Made by: KOZMOS
Pinned commit: No commit pinned yet
Review notes: Listed from the community catalogue awesome-claude-code-mods (https://github.com/karanb192/awesome-claude-code-mods) on 2026-10-18. Not reviewed by modsforClaude.com yet: the hooked events and what it uses come from that catalogue's automated scan of the source.
What a scan found: Calls the model (uses tokens)

Stores data

Shows something on screen

Reported by an automated scan of the source, not checked by a person yet.
Hooked events: UI

How to install

This mod is not in the official Claude directory, so you load it straight from its source on GitHub. modsforClaude.com is an unofficial community site: we do not host, repackage or install anything. Read the source and the review on this page first.

In the terminal

Clone the repository and start Claude Code with the mod. It stays loaded for that session.

git clone https://github.com/ersinkoc/claude-mods
claude --plugin-dir ./claude-mods/mods/ballast

In the desktop app

Clone the repository into a folder you keep:

git clone https://github.com/ersinkoc/claude-mods ~/claude-mods/claude-mods

Add that folder to CLAUDE_CODE_PLUGIN_DIRS in the env block of ~/.claude/settings.json, then start a new session in the Code tab. On Windows, with your own user name:

"env": {
  "CLAUDE_CODE_PLUGIN_DIRS": "C:\\Users\\you\\claude-mods\\claude-mods\\mods\\ballast"
}

On macOS and Linux:

"env": {
  "CLAUDE_CODE_PLUGIN_DIRS": "~/claude-mods/claude-mods/mods/ballast"
}

Already loading other mods this way? Add the folder to the same value, separated by ; on Windows or : on macOS and Linux.

Not working, or want to change its settings? How to load a Claude Code mod walks through every step.

KOZMOS Ballast: a context coach. A toast when the context window passes warnAt, then a band with an anchor and a water-level gauge at actAt: "⚓ ctx 89% — compact before the next big task" with Compact now (queued to the end of a running turn) and Not now. Optional auto-compaction between turns, and a before→after toast for every compaction. /ballast toggles the band.

Made this mod? Add a badge to your README

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/ballast.svg)](https://modsforclaude.com/mods/ballast/)

← All mods

ballast

Related mods

next-steps

code-modernization

fm

fast-jev-compaction

image-view

filetree