Skip to content

Release: v0.1.0

Choose a tag to compare

View all tags
@shinpr shinpr released this 29 Jan 03:56
· 8 commits to main since this release
v0.1.0
f703449

Initial release.

What is metronome?

A Claude Code plugin that prevents Claude from taking shortcuts on repetitive tasks.

When Claude encounters repetitive work, it tends to declare "I'll work efficiently" and then switches from step-by-step edits to bulk operations (e.g. sed one-liners), often breaking files and losing uncommitted changes in the process.

Metronome detects such declarations and blocks the Bash tool call, reminding Claude to slow down.

How it works

  • Runs as a PreToolUse hook on the Bash tool
  • Scans the most recent assistant message in the transcript for efficiency-related phrases
  • Supports 9 languages: English, Japanese, Chinese, German, French, Spanish, Portuguese, Korean, and Russian
  • When triggered, denies the tool call with positive guidance: "Slow down. Read the current task, execute it, verify the result, then move to the next."

Installation

claude
/plugin marketplace add shinpr/metronome
/plugin install metronome@metronome
# Restart Claude Code

Requirements

  • Claude Code 1.0.33+
  • Python 3

Known limitations

  • Plugin hooks have a known execution bug in local development (--plugin-dir). If hooks do not fire, add the hook configuration to .claude/settings.json as a workaround. See claude-code#14410.

License

MIT

Assets 2
Loading