mod-usage in action

mod-usage

mod-usage · by Jack Chiang

Shows context, 5-hour, and 7-day usage as gradient bars above the prompt. Desktop/VS Code only; 12 languages supported, not Korean yet.

❯ /plugin marketplace add SeongGwangJu/k-mods
❯ /plugin install mod-usage@k-mods

Run /reload-plugins to apply it to an open session. Needs Claude Code 2.1.287 or later.

Notes

  • Korean is not a supported language yet. It displays in English even on a Korean locale.
  • Even on a Korean locale (ko_KR and so on), ko is not among the 12 supported languages, so it falls back to English automatically. Until a translation patch is merged, Korean is also missing from the language choices in /plugin configure.
  • It is not drawn in the terminal. It is for Claude Code Desktop/VS Code/mobile only, and the CLI keeps using its own status line.
  • The 5-hour and 7-day bars are shown only to Claude subscribers. With an API key, only the context bar is shown (per the original README; k-mods did not verify this directly).
  • Only when no LANG-type environment variable is set at all on macOS, it runs /usr/bin/defaults read -g AppleLanguages once internally to read the system language. The arguments are fixed and no user input goes in.

What it can do on your machine

Mods run unsandboxed with your permissions. These labels come from static analysis.

Runs programsReads env/settings
Static analysis

Events handled

session.measuresession.startui.render{component=AbovePrompt}

Environment variables read

LANGLC_ALLLC_MESSAGES