Skip to content

v5.1.0 — Context Window Monitor & Customisable Status Line

Choose a tag to compare

View all tags
@ChanMeng666 ChanMeng666 released this 12 Apr 23:11
· 69 commits to master since this release
v5.1.0
2288325

What's new

Context window monitor in the status line

The status line now tracks context window usage in real time with color-coded thresholds that warn you before entering the "agent dumb zone" — when context exceeds 60–70%, Claude starts ignoring instructions and making basic coding errors.

Color Range What it means What to do
🟢 Green < 50% Safe — agent performs well Nothing, keep working
🟡 Yellow 50–80% Caution — entering the "dumb zone" Type /compact or /clear
🔴 Red > 80% Danger — agent makes frequent errors Type /compact immediately 
[Opus] 🔊 Audio Hooks v5.1.0 | 6/26 Sounds | Webhook: off | Theme: Voice
🌿 main  ████░░░░ API Quota: 60%  █████░░░ Context: 65% ⚠️ /compact

10 customisable status line segments

Users can choose exactly which segments to show. Just tell Claude Code in natural language:

  • "Only show context usage in the status line" → shows just the context bar
  • "Show context and API quota" → shows two progress bars
  • "Show everything" → resets to all 10 segments (default)

Available segments: model, version, sounds, webhook, theme, snooze, focus, branch, api_quota, context.

audio-hooks set statusline_settings.visible_segments '["context"]'
audio-hooks set statusline_settings.visible_segments '["context","api_quota"]'
audio-hooks set statusline_settings.visible_segments '[]'   # show all (default)

Human-readable display labels (global accessibility)

All status line labels redesigned so non-English-native, non-technical users can understand them at a glance:

Before After
ctx: 65% Context: 65%
5h: 60% API Quota: 60%
24/26 hooks 24/26 Sounds
theme: custom Theme: Chimes
theme: default Theme: Voice
SNOOZED MUTED

Old config segment names (ctx, hooks, rate_limit) are still accepted for backwards compatibility.

SKILL.md now covers all features

The /audio-hooks SKILL (the natural-language interface Claude Code uses) now documents every project capability. 8 previously missing sections added:

  • Check project status — audio-hooks status / audio-hooks version
  • Notification settings — audio-only, notification-only, per-hook overrides
  • Playback settings — debounce configuration
  • Focus Flow — breathing exercises, min thinking seconds
  • Uninstall — plugin and script paths
  • Generic get/set — read/write any config key
  • Webhook view — audio-hooks webhook (view current config)
  • Status line customisation — segment selection with examples

Install / upgrade

If you already have the plugin installed, Claude Code will pick up the new version automatically on next plugin update. For new installs:

Tell Claude Code: "Install the audio-hooks plugin from github.com/ChanMeng666/claude-code-audio-hooks"

Then type /reload-plugins once. That's it — natural language forever after.

Files changed

  • bin/audio-hooks-statusline.py — context bar, segment filtering, human-readable labels, backwards-compat alias system
  • bin/audio-hooks.py — cmd_status now emits statusline_settings
  • config/default_preferences.json — new statusline_settings.visible_segments key
  • plugins/audio-hooks/skills/audio-hooks/SKILL.md — full feature coverage, 8 new sections
  • CLAUDE.md — updated config table and decision tree
  • README.md — new status line section with mermaid diagram, segment table, examples
  • docs/ARCHITECTURE.md — updated statusline documentation

Full Changelog: v5.0.3...v5.1.0

Assets 2
Loading