Leitstand

Disk space and context warnings in Claude Code

·

source at c240234

·

MIT license

A strip above the prompt that warns when disk space runs low, when context passes 250k tokens, or when one of your hooks blocks a tool call.

What this mod can do

  • Reviewed at commit c240234
  • Runs programs
  • Reads environment variables
  • Sees each prompt you send and can change or drop it
  • Sees each tool call before it runs and can block or change it
3 more things it can do
  • Remembers data between sessions
  • Adds the /stand command
  • Runs on a timer
Good to know (3)
  • Warns at 35 GB free and turns red at 20 GB; closing the list acknowledges it until the next level
  • Set LEITSTAND_DISK_HOST to measure an ssh host's disk instead; that needs key-based login
  • On macOS it plays a sound when long work ends (silent on Linux); LEITSTAND_SOUND=off mutes it
Are mods safe?

Preview

Terminal

! needs you disk · 19 GB free ▓············· 10 % [-] ! 1 needs you /stand

Claude Desktop

Leitstand in Claude Desktop

What it does

In the author's words

A control room above your prompt: background agents and shells, disk space and context at a glance. Two themes, loud and quiet. /stand toggles the list.

What you see
A disk and context list above the prompt
Works in
Terminal and Claude Desktop
Slash commands
/stand
Uses your tokens
No
Changes files
Only through programs it runs
Network access
Only through programs it runs
Reviewed commit
c240234
Preview recorded with
Claude Code 2.1.309

How it works

  1. Stays hidden until something needs you; /stand opens or closes the list any time
  2. Runs df every 5 minutes to measure free disk space on this machine
  3. Turns the context row yellow with compact once the session passes 250k tokens
  4. When a hook blocks a tool call, shows the hook's name and reason until your next prompt

Common questions

How do I see free disk space while Claude Code works?

Leitstand runs df every 5 minutes and shows free space as a row above the prompt, with a bar and the percent used. It warns at 35 GB free and turns red at 20 GB. Type /stand to open the list any time.

How do I know when to run /compact?

From 250k tokens used, the context row turns yellow and says compact as a reminder to run /compact. Leitstand never compacts by itself.

Can I see why a hook blocked a tool call?

Yes. When one of your hooks blocks a tool call, Leitstand shows the hook's name and its reason above the prompt until your next prompt.

How do I switch to the quieter theme?

Set LEITSTAND_THEME=quiet in your shell, or in the env block of ~/.claude/settings.json, and start a new session. The quiet theme has thin bars and no footer, and shows the disk only when it runs low.

Badge for your README

Own this listing? Add it to your README. The badge shows the install count as it grows.

Reviewed on statuslin.es
[![Reviewed on statuslin.es](https://statuslin.es/badge/mods/leitstand.svg)](https://statuslin.es/mods/leitstand?utm_source=readme-badge)

Or show the preview card:

Preview on statuslin.es
[![Preview on statuslin.es](https://statuslin.es/og/mods/leitstand.png)](https://statuslin.es/mods/leitstand?utm_source=readme-badge)

More like this

Token Weather Usage in Claude Desktop

One line above the prompt: context tokens with their weather, a bar per recent prompt, your 5-hour and 7-day limits against the time elapsed, the prompt cache with its time left, the session cost with the last prompt's share in dollars and in points of the 5-hour limit, the subagents running, and a one-click pill for the GOs Claude proposes. Labels in English, French or Russian. After Token Weather (Anthropic, Apache-2.0) and the ideas of usage-meter (HolyGrail) and prompt-cache-control (Daniel San).

Deck in Claude Desktop

A cockpit for Claude Code: plan bars and subagent strips, context, usage limits with reset countdowns and burn rates, spend, the model route and a pet. Six bar styles, three collapsed looks. CLI and Desktop.

Context Bar in Claude Desktop

Your context window as a stacked bar above the prompt, a color per category, with token counts and the compaction point. /context-bar shows or hides it.

Flightdeck in Claude Desktop

Flightdeck: a live agent dashboard for Claude Code. Main model vitals, an on-call architect, every permission check, subagent cards and swimlanes, a turn receipt and a session log, all from real session events

╭─ CONTEXT ────────────────────────────────────────────╮ │ ████▊░░░░░░░░░░░░░░░░░ 22% of 200K · GOOD │ ├─ STATS ──────────────────────────────────────────────┤ │ ↓ 44.0K ↑ 1.4K │ $0.41 │ ⏱ 10m 12s │ +128/-34 │ ├─ REPO ───────────────────────────────────────────────┤ │ ◆ Opus 4.8 · main · 16:21 │ ╰──────────────────────────────────────────────────────╯

A boxed multi-line panel with auto-sizing borders: a context section with a gradient bar and status word, a stats section (tokens, cost, duration, lines changed), and a repo section (model, git branch with file counts, clock, vim mode), in a terracotta Claude-brand palette.

app · main · Opus-4.8 · effort high · ctx 22% · 5h 26% ↻2h6m · 7d 7% ↻2d0h

One-line status bar showing your directory, git branch (with a * when dirty), model, live effort level, context-window usage, and 5-hour/7-day rate-limit usage.

Opus 4.8 [high] ~/app main 16:20:55 | ⛁ ██░░░░░░░░ 22% | 5h ●◔○○○ 26% ↻2h7m | 7d ◔○○○○○○ 7% ↻2d1h │ $0.41 ⏱ 10m

Two-line status with a block context bar and quarter-step dot meters (◔◑◕●) for the 5-hour and weekly limits (fill shows usage, color shows whether you are ahead of or behind pace), plus model, effort, git and cost. Needs no jq.

████▊░░░░░░░░░░░░░░░░░ 22% of 200K · GOOD │ ↓ 44.0K ↑ 1.4K │ $0.41 │ ⏱ 10m 12s │ +128/-34 │ 5h 26% ↻2h06m │ 7d 7% ↻2d0h │ ◆ Opus 5.5 · main · 03:53

One-line adaptation of @kyleledbetter's Dreambase Panel: a context bar with status word, token/cost/duration/lines-changed stats, and model + git branch + clock, all on a single line in a terracotta Claude-brand palette.