Skip to main content

Command line tool

autosignly is a small CLI for developing an integration on your own machine. Its main job: forwarding webhooks to localhost without exposing your laptop to the internet or setting up a tunnel.

npm install -g autosignly

Versions: the supported line is 1.0.*. The newest release of each package is listed among the tags in the repository.

Requires Node 20 or newer.

Signing in​

autosignly login

You are asked for the API key and secret. The secret is read without echoing and never lands in your shell history. Credentials are stored per API address in ~/.config/autosignly/credentials.json, so a production and a sandbox login can live side by side. The tool reports which environment the key resolves to and warns you loudly when it is production; listen then prints the company as well before it starts forwarding.

Forwarding events​

autosignly listen --forward-to http://localhost:8000/webhooks/autosignly

Every event is delivered to that address as a POST with the original X-Webhook-Signature and X-Webhook-Timestamp headers, and the body arrives byte for byte as it was signed — so the signature check you wrote for production works unchanged locally.

Each delivery is reported as it happens:

ok  DOCUMENT_SIGNED  ->  200  (48 ms)

Use --skip-verify to drop the signature headers while your handler has no key configured yet.

Signing out​

autosignly logout

Removes the stored credentials for the current API address.