Skip to content
HookNexus

CLI troubleshooting

Not logged in

Sign in again:

Terminal window
hooknexus login

If the problem persists, run hooknexus whoami and confirm your JWT is still valid (try logging out and back in).

Request not found

Request ids must be complete. List requests for the endpoint first:

Terminal window
hooknexus requests ls <endpoint-id>

Then use the full id with show, body, or replay.

Target URL must be localhost

Non-local targets require an explicit opt-in:

Terminal window
hooknexus forward --to http://example.com/webhook --allow-external

Without --allow-external, only localhost, 127.0.0.1, and .local hosts are allowed.

Forwarded requests return 404

--to must include the path your local server listens on. A URL like http://localhost:8788 with no path sends the request to /, which often 404s.

Use a full URL, for example http://localhost:8788/your/webhook/route (your route will differ). See Local forwarding.

Request replay is available on the Plus plan and above

Request replay is not included on Free. Upgrade from the CLI:

Terminal window
hooknexus upgrade

Or use the web app billing / subscription UI.

Still stuck?

  • Run hooknexus --help and hooknexus <command> --help for up-to-date flags.
  • Set HOOKNEXUS_DEBUG for extra diagnostic output when supported.
  • Check Install & quick start for API URLs and how the CLI stores your session.
  • Report issues or browse source: hooknexus/hooknexus-cli on GitHub.