Install

Install the Hooksbase CLI.

Use the CLI to inspect projects, manage webhooks, send test events, replay deliveries, and work with DLQ entries from a terminal.

$curl -fsSL https://www.hooksbase.com/install | bash

Package managers

Install from npm with the tool you already use.

The curl installer uses npm under the hood. These commands install the same public package directly.

npm

Install @hooksbase/cli globally with npm.

npm install -g @hooksbase/cli
pnpm

Install @hooksbase/cli globally with pnpm.

pnpm add -g @hooksbase/cli
bun

Install @hooksbase/cli globally with bun.

bun install -g @hooksbase/cli

After install

Verify the command before wiring it into automation.

Prerequisite

The curl installer requires Node.js and npm on the target machine.

node --version && npm --version
Verify

Confirm the hooksbase executable is on PATH and ready to use.

hooksbase --help
Pin a version

Install a specific CLI release when reproducibility matters.

curl -fsSL https://www.hooksbase.com/install | bash -s -- --version 0.4.0

Frequently asked questions

Installing the CLI, answered.

How do you install the Hooksbase CLI?

Either pipe the installer — curl -fsSL https://www.hooksbase.com/install | bash — or install the package directly with npm install -g @hooksbase/cli, pnpm add -g @hooksbase/cli, or bun install -g @hooksbase/cli. All four install the same public package; the curl installer uses npm under the hood, so Node.js and npm must already be present on the target machine.

How do you install a specific CLI version?

Pass --version to the installer: curl -fsSL https://www.hooksbase.com/install | bash -s -- --version 0.4.0. Pin a version when you need a reproducible install, such as in CI or a container image, rather than tracking the latest release.

How do you check the CLI installed correctly?

Run hooksbase --help. If the command resolves, the executable is on your PATH and ready to use. If it does not, the global npm bin directory is probably missing from PATH — npm bin -g prints the directory that needs to be on it.

Why does the same URL return a shell script sometimes?

https://www.hooksbase.com/install content-negotiates. Requests from curl, wget, and similar clients get the install script as text/x-shellscript so the pipe-to-bash form works; browsers and crawlers get this HTML page. It is one URL either way, which is what makes the install command short enough to paste.

What is Hooksbase?

Hooksbase is event infrastructure for AI agents. It ingests events over four channels — HTTP, email, HTML form, and scheduled cron — verifies them, routes them by rule, runs versioned Automations in the event path, and delivers them to HTTP and cloud destinations (AWS SQS, AWS EventBridge, GCP Pub/Sub, and S3-compatible storage) with retries, strict ordering, Standard Webhooks-compatible signing, deterministic replay, and a dead-letter path. It is a hosted service, runs on Cloudflare Workers, is operated at hooksbase.com, and is not affiliated with — and shares no code or ownership with — other similarly named webhook, hook, or tunnelling tools.