Command line

The hap CLI

Run your Happenings page from the terminal. Events, tickets, orders and members are one command away, with JSON for your scripts.

$ curl -fsSL https://happenings.social/install.sh | bash

Apple silicon and Intel

$ curl -fsSL https://happenings.social/install.sh | bash

x86_64 and arm64

What it installs

The hap program, in /usr/local/bin or ~/.local/bin
The Happenings skill for any coding agents it finds

Read the script first

hap

$ hap login  Scan with the Admin app, or enter this code:  K7QD-M2XP  Waiting for approval... (Ctrl-C to cancel) $ hap access pages use fredagsbar-aarhusActive page set to Fredagsbar Aarhus (fredagsbar-aarhus) [5e2c9a10-7d41-4b6e-9f3a-2c81d0e4b7a5] $ hap events listID        TITLE             STATUS                  START             VENUE           --------------------------------------------------------------------------------------3f9a2c71  Fredagsbar        EVENT_STATUS_PUBLISHED  2026-09-25 15:00  Studenterhuset  8b41e0d2  Rusfest 2026      EVENT_STATUS_PUBLISHED  2026-10-03 21:00  Train           c07d5a19  Quiz night        EVENT_STATUS_DRAFT      2026-10-08 19:30  Stakladen        $ hap events list --json | jq -r '.[].title'FredagsbarRusfest 2026Quiz night

Up and running in a minute

Four steps from zero to your first list of events.

1
Install
One command picks the right build for your machine and puts hap on your PATH.
```
$ curl -fsSL https://happenings.social/install.sh | bash
```
2
Sign in
Scan the QR code with the Admin app. On the same computer you can sign in in the browser instead.
```
$ hap login
```
```
$ hap login --browser
```
3
Pick your page
See the pages you manage and make one your default.
```
$ hap access pages list
```
```
$ hap access pages use <slug>
```
4
Go
Every command takes --json, and lists take --csv too.
```
$ hap events list --json
```

What you can do

Commands follow your role on each page. Run hap --help for everything.

Events
Create, publish and cancel events, and see who's coming.
```
$ hap events list
```
```
$ hap events publish <id>
```
Tickets and check-in
Ticket types, comps, check-ins and live door stats.
```
$ hap tickets list --event <id>
```
```
$ hap checkin stats --event <id>
```

Orders

Orders, refunds and CSV exports for your books.

$ hap orders list

$ hap orders export --start 2026-09-01 --output orders.csv

Members
Find, approve and export members, and manage plans.
```
$ hap members find anna
```
```
$ hap members export
```

Analytics

Headline numbers, daily trends, funnels and retention.

$ hap analytics page-quick-stats

$ hap analytics page-timeseries

Announcements

See who'll get it, then send a page announcement.

$ hap notifications preview-audience

$ hap notifications send

Hand it to your AI assistantLet Claude or Codex run your page for you over MCP.

Every command explained

Built-in help for each command, with examples.

$ hap --help

Update and uninstall

Updating is one command. Uninstalling takes three.

Update
Check for a new version, then install it.
```
$ hap update --check
```
```
$ hap update
```
Uninstall
Sign out, remove the program, then your settings.
```
$ hap logout$ sudo rm /usr/local/bin/hap$ rm -rf ~/.happenings
```
Installed without sudo? Then hap lives in ~/.local/bin instead.

Questions

Does it run on Windows?

Not directly. hap runs on macOS and Linux, so on Windows use it inside WSL.

Do I need an API key?

No. hap login signs you in with your Happenings account, and hap logout signs you out.

What am I allowed to do?

Exactly what your role on each page allows. The CLI never gives you more than Connect does.

Does it work over SSH?

Yes. The QR sign-in needs nothing running on the remote machine, so it works on servers too.

Is it safe to pipe a script into bash?

Read it first if you like. It's plain text at happenings.social/install.sh, and all it does is download hap and set up the agent skill.

Can I use it in scripts?

Yes. Add --json, --jsonl or --csv and pipe the output wherever you want.

The hap CLI

Up and running in a minute

Install

Sign in

Pick your page

Go

What you can do

Events

Tickets and check-in

Orders

Members

Analytics

Announcements

Update and uninstall

Questions

Analytics choices