The hall counts its visitors: a digest, a nightly rollup, and the games it sends people to

gamehall/ops holds the traffic counter, the visitors digest and the
nightly rollup, installed by gamehall/deploy.sh; the gamehall-visitors
skill reads them. The hall now sends its origin as referrer, so a game
can tell who came from it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Jm2auWk6RP71CjaAb4FMoG
This commit is contained in:
Eric Wagoner
2026-09-26 12:41:55 -04:00
co-authored by Claude Opus 5.5
parent 8ab1e0b794
commit 1dbf5763e1
8 changed files with 212 additions and 1 deletions
+38
View File
@@ -0,0 +1,38 @@
---
name: gamehall-visitors
description: Who is visiting Kestrel's Hall, the landing page at gamehall.kestrelsnest.social - the last hour, today, where they came from, how many went on into each game, and the week's trend. Use when Eric asks about hall traffic or visitors.
---
# Kestrel's Hall visitors
One command on the shared host prints the digest:
ssh root@159.203.115.252 /usr/local/bin/gamehall-visitors.sh [YYYY-MM-DD]
Default is today, UTC. It reads Caddy's access log for the hall's own
name (the sslip test address is left out) and prints:
- **last hour** (today only): people and page views, the "right now".
- **today**: people (distinct addresses), page views, bot addresses.
- **referrers** and **campaigns**: the sites that sent people, and the
tags links carry (`?ref=`, utm_source, Facebook's fbclid). Reddit and
some apps send no referrer.
- **went on to**: people each game on this host (Dip, Waving Hands,
Hnefatafl) received with the hall as referrer. The hall sends its
origin as referrer, nothing more. Wiz-War is on its own droplet; its
own digest (/wizwar-visitors) lists gamehall.kestrelsnest.social among
its referrers.
- **last 7 days** from `/var/lib/gamehall/rollup.jsonl`, written nightly
at 00:05 UTC by `gamehall-rollup.sh` for the day before (counts only,
no addresses).
## Read it
Lead with whether anyone is here now and today's people, then where they
came from, then how many went on into a game (the hall's job is to send
people to tables). Give the week's direction from the rollup in one
sentence. Eric's own devices count as people; a handful on a quiet day
may be him.
The source is `gamehall/ops/` in game-kit; `gamehall/deploy.sh` installs
it on every publish.