s0xdk/ghostty-blackhole

Ghostty Blackhole puts a real, ray-traced black hole inside your terminal window, one that grows as your AI coding session fills up. If you use Claude Code, the hole starts small in the corner when your context is empty and swallows more of your screen as the context window fills. The visual cue tells you when a /compact command is coming, so you're never surprised by a session running out of room. If no session is running, the hole disappears entirely and you just get a normal terminal. The black hole is rendered using real physics. Every pixel near the hole traces the path a photon would take around a black hole, bending light exactly as gravity would. Your terminal text becomes the background sky that gets lensed and distorted, text near the hole stretches into a ring, and text behind it genuinely disappears. There's also an accretion disk with relativistic coloring, where the side moving toward you glows blue-hot and the receding side dims to red. None of this is painted on, it all emerges from the ray-tracing math. The clever part is how the hole knows how full your context is. The terminal shader can't receive custom data directly, but it can read cursor color. A small helper script encodes your context fill percentage into the cursor's color, and the shader decodes it back every frame. When you start a new session or run /compact, the hole snaps back to its tiny corner seed. When you exit, it vanishes. There's also a pomodoro mode that grows the hole over a work period and shrinks it during breaks, though the README notes a current limitation: the wall-clock feature in Ghostty doesn't work yet, so only the idle detector functions. Token mode, the default, is unaffected. This is for developers using the Ghostty terminal who work with Claude Code and want a visual, ambient sense of their context budget, or just want a striking, physics-accurate black hole on their screen.