Known issue: hookdeck listen can stop delivering events (CLI_UNAVAILABLE) after an extended disconnect

[leggetter]

Summary

Long-running hookdeck listen sessions can enter a state where the CLI appears connected but stops delivering events. In the Hookdeck dashboard, delivery attempts fail with CLI_UNAVAILABLE.

Symptoms

• hookdeck listen looks like it's still running/reconnecting, but events stop arriving at your local server.
• The dashboard shows delivery attempts failing with CLI_UNAVAILABLE.
• There's no obvious error in the CLI output.

When it happens

The CLI's server-side session can expire — for example after your machine has been asleep or offline for a while. Affected CLI versions don't automatically re-establish an expired session, so the connection can get stuck retrying a session that no longer exists.

Fix (recommended): update the CLI

This is resolved in v2.3.2 and later — newer versions automatically re-establish an expired session on reconnect, with no restart needed.

• npm: npm install -g hookdeck-cli@latest
• Homebrew: brew upgrade hookdeck

Workaround (until you update)

Stop and restart listen:

1. Press Ctrl+C to stop hookdeck listen.
2. Run your hookdeck listen … command again.

This creates a fresh session and delivery resumes. You do not need to log out / log in.

Affected versions

All releases up to and including v2.3.1.