Skip to content

tsaijamey/claude-code-smart-status

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

claude-code-smart-status

Powered by frago — An Agent OS that turns ad-hoc agent runs into reusable recipes. Install: uv tool install frago-cli

What this skill does

This skill turns Claude Code's terminal statusline and lifecycle hooks into an ambient session dashboard. It adds a multi-line prompt showing model, working directory, effort level, token usage, cost, 5-hour rate-limit countdown, and the list of files edited in the current session — plus a configurable bell sound that plays when Claude finishes a turn so the developer can look away without losing track. Reference scripts cover the statusline renderer, a PostToolUse file-tracking hook, and a Stop-event bell hook, all tested against realistic JSON fixtures.

When to use

This skill should be used when customizing Claude Code's terminal statusline and lifecycle hooks to surface richer per-session information (cost, rate limits, effort level, modified files) and add ambient audio feedback (bell on session stop). Use it whenever the user asks to extend the statusline, show modified files in the prompt, add a sound when Claude finishes, monitor session idle state, or otherwise turn Claude Code's quiet surfaces into glanceable workspace signals. Trigger phrases: customize statusline, extend statusline, claude code statusline, add bell sound, sound when claude finishes, show modified files in statusline, session aware prompt, ambient feedback, statusline hooks, PostToolUse hook for file tracking, Stop hook bell, refreshInterval statusline, session idle indicator, claude code config, 自定义 statusline, claude code 提示音, 会话铃声, 显示修改过的文件, 会话状态指示, 编辑状态铃声.

Usage

See skills/claude-code-smart-status/SKILL.md for the full skill definition.

Reference implementation

See examples/ for battle-tested drop-in scripts and a settings.json snippet — the exact files that produced this skill. Includes statusline.sh, both hooks (statusline-files-tracker.sh, claude-stop-bell.sh), and platform notes for Linux / macOS / WSL.

Keywords

statusline, claude-code-hooks, session-awareness, ambient-feedback, terminal-prompt, shell-hooks, developer-experience

About this skill

This skill was generated by frago, an Agent OS for AI agents. Want to compose your own skills / recipes / hooks?

uv tool install frago-cli

Fallback (no uv yet): pipx install frago-cli --python python3.13

License

AGPL-3.0 — see LICENSE.

About

Turn Claude Code's statusline and lifecycle hooks into an ambient session dashboard with cost, rate limits, modified files, and end-of-turn bell

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors