vibestretch — Claude Code hook: breaks and setup
vibestretch is a Claude Code hook that prints a stretch or eye-rest prompt and plays a soft chime after the agent has kept you waiting. It runs on prompt submission, tool use, and agent stop.
MIT ★ 1,596 updated 2026-10-29
.claude/settings.jsonWhat vibestretch does
vibestretch prints one brief reminder to stretch or rest your eyes, then plays a soft chime after a wait of several minutes. Its scripts/vibestretch.sh script runs when a prompt is submitted, after a tool is used, and when the agent stops.
The hook calls the script with start, check, and stop actions. It uses no model tokens and sends no telemetry. For Claude Code, add the hook settings to .claude/settings.json.
What it helps with
- prompt a stretch during an agent wait
- remind you to rest your eyes
- signal a long pause with a chime
Example prompts for the agent
- Analyze the project structure.
- Find the cause of the test failure.
- Explain how this module works.
How to install vibestretch
Manually: put the files in place
.claude/settings.jsonThe hooks block: event (PreToolUse, PostToolUse, Stop…) → command. Personal ones go to ~/.claude/settings.json
Step by step, with commands for each platform: Claude Code hooks: what they are, where to configure them, how to block a risky command
Questions about vibestretch
How do I install vibestretch in Claude Code?
Add the hook settings to .claude/settings.json.
What does vibestretch do?
It prints a stretch or eye-rest reminder and plays a soft chime after the agent has kept you waiting for several minutes.
Which events trigger vibestretch?
It runs on prompt submission, after tool use, and when the agent stops.
Source text
codex-hooks.json · MIT
Hooks bundle shipped with the vibestretch plugin for Claude Code.
Codex hooks that print one stretch or eye-break line and play a soft chime once the agent has kept you waiting for minutes, with zero model tokens and no telemetry (also Claude Code and Gemini CLI).
Triggers on: PostToolUse, UserPromptSubmit, Stop.
```json
{
"hooks": {
"UserPromptSubmit": [
{
"hooks": [
{
"type": "command",
"command": "\"${PLUGIN_ROOT:-$HOME/.codex/vibestretch}/scripts/vibestretch.sh\" start codex",
"async": true,
"timeout": 5
}
]
}
],
"PostToolUse": [
{
"matcher": ".*",
"hooks": [
{
"type": "command",
"command": "\"${PLUGIN_ROOT:-$HOME/.codex/vibestretch}/scripts/vibestretch.sh\" check codex",
"timeout": 5
}
]
}
],
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "\"${PLUGIN_ROOT:-$HOME/.codex/vibestretch}/scripts/vibestretch.sh\" stop codex",
"async": true,
"timeout": 5
}
]
}
]
}
}
```
© Junit · MIT · hashgraph-online/awesome-codex-plugins