The original title is about Claude Code hitting its limit and notifications not coming. Let me rewrite this for a mobile feed.

Short summary

A developer building claude-code-notify discovered that usage-limit notifications were silently failing because the tool's hook read Claude Code's transcript file before the rate-limit envelope was fully written to disk. The root cause was a race condition: the StopFailure hook fired before Claude Code's asynchronous file write completed, causing the detection logic to see an incomplete transcript. A 200ms retry delay fixed the issue, but the author notes this only papers over a deeper race that deserves a more robust solution.

• •Usage-limit notifications silently failed due to a file read/write race condition
• •Hook read transcript 19.7ms before Claude Code finished writing the rate-limit envelope
• •200ms retry delay fixed the immediate issue but doesn't fully solve the underlying race

Generated with AI, which can make mistakes.