Document multiple sources in listen command

[leggetter]

Summary

Enhanced the listen command to support forwarding events from multiple sources simultaneously, in addition to the existing single-source functionality.

Changes

• Updated command usage to accept [source(s)] instead of [source], indicating support for multiple sources
• Modified help text to document three listening modes:
  • Single source by name
  • Comma-separated list of sources (e.g., "shopify,stripe")
  • All sources using "*" wildcard
• Clarified that source argument is now optional (CLI prompts if omitted)
• Updated documentation to note that automatic source creation only applies to single-source mode
• Added examples demonstrating multiple-source and wildcard listening patterns
• Updated REFERENCE.md to reflect the new functionality

Implementation Details

• The changes are primarily documentation and help text updates
• The actual argument parsing and multi-source logic implementation is not visible in this diff (likely handled elsewhere in the codebase)
• Help text now clearly distinguishes between single-source automatic creation and multi-source listening capabilities

https://claude.ai/code/session_01RpnqJcy3FFXtUQvSnMA8m2

[alvarp]

Check the two comments related to the port, I believe that the examples are broken.

[alvarp]

The port in the example seems broken

[leggetter]

%[1]d here is a Go fmt.Sprintf verb, not a literal — the whole Examples block is built via fmt.Sprintf(..., 3000), so this renders as hookdeck listen 3000 shopify,stripe. It matches the pre-existing examples in the same block (e.g. hookdeck listen %[1]d shopify a few lines up), which also use %[1]d. GitHub only let you comment on the newly-added lines, so the identical older lines aren't flagged. Happy to switch the entire block to a literal 3000 if you'd prefer that for readability, but I left these consistent with the surrounding examples.

---

Generated by Claude Code

[alvarp]

Same, broken port.

[leggetter]

Same as above — %[1]d is a fmt.Sprintf placeholder that renders as 3000 (hookdeck listen 3000 '*'), consistent with the rest of the Examples block.

---

Generated by Claude Code