https://github.com/tsaijamey/claude-code-smart-status
Turn Claude Code's statusline and lifecycle hooks into an ambient session dashboard with cost, rate limits, modified files, and end-of-turn bell
https://github.com/tsaijamey/claude-code-smart-status
agent-skills ambient-feedback claude-code claude-code-hooks developer-experience frago session-awareness shell-hooks statusline terminal-prompt
Last synced: 5 days ago
JSON representation
Turn Claude Code's statusline and lifecycle hooks into an ambient session dashboard with cost, rate limits, modified files, and end-of-turn bell
- Host: GitHub
- URL: https://github.com/tsaijamey/claude-code-smart-status
- Owner: tsaijamey
- License: agpl-3.0
- Created: 2026-05-16T10:41:27.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-24T01:50:00.000Z (23 days ago)
- Last Synced: 2026-05-24T03:26:16.676Z (23 days ago)
- Topics: agent-skills, ambient-feedback, claude-code, claude-code-hooks, developer-experience, frago, session-awareness, shell-hooks, statusline, terminal-prompt
- Size: 23.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# claude-code-smart-status
> Powered by **[frago](https://frago.ai)** — 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`](skills/claude-code-smart-status/SKILL.md) for the full skill definition.
## Reference implementation
See [`examples/`](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](https://github.com/tsaijamey/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](LICENSE).