Skip to main content
hook CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/settings.json
Open on GitHub

What 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.json

The 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

Similar hooks

All hooks for Notes, tasks and projects →

From the same set391

The whole set →
dataproduct-builder-dbt dataproduct-builder-dbt runs data contract linting right after file edits in dbt projects. Helps maintain ODCS, ODPS, and OpenLineage standards across your data product builds. CX Codex ★ 1,596repo stars codex-seo This hook runs a schema check when Claude Code edits or writes a file. It ships with codex-seo, a plugin bundle for SEO workflows. CX Codex ★ 1,596repo stars carsxe carsxe is a Claude Code hook that loads the CarsXE API key at session start. The API provides vehicle data such as VIN details, market value, history, and OBD codes. CX Codex ★ 1,596repo stars wtfm wtfm generates illustrated end-user help articles from codebase files and renders screenshots locally from the actual interface code. CX Codex ★ 1,596repo stars tree-ring-memory tree-ring-memory is a Claude Code hook that loads saved context when a session starts and checks memory when it ends. It also runs at subagent start and stop. CX Codex ★ 1,596repo stars tailtest tailtest detects files modified during an agent turn and triggers automated test writing and execution. Works across 8 languages with zero config. CX Codex ★ 1,596repo stars stop-that-shit The stop-that-shit hook for Claude Code and Codex checks agent actions against explicit task modes and bounds decisions about dependencies, hashes, and subagents. CX Codex ★ 1,596repo stars board A SessionStart hook that tells the agent what is on the project board. The board lives in plain Markdown files, so you can read it straight from the terminal. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open