Command line

The happenings 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?cli=page" | bash

Apple silicon and Intel

$ curl -fsSL "https://happenings.social/install.sh?cli=page" | bash

x86_64 and arm64

What it installs

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

Read the script first

happenings

$ happenings loginOpening browser to authenticate...Waiting for authentication...Logged in as Anna Holm (anna@example.com) $ happenings access pages use fredagsbar-aarhusActive page set to Fredagsbar Aarhus (fredagsbar-aarhus) [5e2c9a10-7d41-4b6e-9f3a-2c81d0e4b7a5] $ happenings 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        $ happenings 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 happenings on your PATH.
```
$ curl -fsSL "https://happenings.social/install.sh?cli=page" | bash
```
2
Sign in
Your browser opens and you sign in with your Happenings account. There is nothing to copy or paste.
```
$ happenings login
```

Pick your page

See the pages you manage and make one your default.

$ happenings access pages list

$ happenings access pages use <slug>

4
Go
Every command takes --json, and lists take --csv too.
```
$ happenings events list --json
```

What you can do

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

Events
Create, publish and cancel events, and see who's coming.
```
$ happenings events list
```
```
$ happenings events publish <id>
```

Tickets and check-in

Ticket types, comps, check-ins and live door stats.

$ happenings tickets list --event <id>

$ happenings checkin stats --event <id>

Orders

Orders, refunds and CSV exports for your books.

$ happenings orders list

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

Members

Find, approve and export members, and manage plans.

$ happenings members find anna

$ happenings members export

Analytics

Headline numbers, daily trends, funnels and retention.

$ happenings analytics page-quick-stats

$ happenings analytics page-timeseries

Announcements

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

$ happenings notifications preview-audience

$ happenings 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.

$ happenings --help

Update and uninstall

Updating is one command. Uninstalling takes three.

Update

Check for a new version, then install it.

$ happenings update --check

$ happenings update

Uninstall
Sign out, remove the program, then your settings.
```
$ happenings logout$ sudo rm /usr/local/bin/happenings$ rm -rf ~/.happenings/page
```
Installed without sudo? Then happenings lives in ~/.local/bin instead.

Questions

Does it run on Windows?

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

Do I need an API key?

No. happenings login signs you in with your Happenings account, and happenings 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, with one extra step. Signing in opens a browser, so forward a port over SSH and pass it with --callback-port. After that 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?cli=page, and all it does is download happenings 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.