Before you start
- Get invited to the Hook Club 1Password account with access to the shared
developervault. It holds the GitHub Packages token, theworkspaceclone script, and the app secrets. - Get added to the thehookclubdev GitHub org.
- Create an SSH key in 1Password (New Item, SSH Key) and add its public key to your GitHub account (Settings, SSH and GPG keys). It stays in your vault; nothing is written to disk.
Run the install
Paste this into Terminal:
curl -fsSL https://thehookclub.dev/install.sh | bashYou'll be asked for your macOS password once. It's safe to re-run: every step checks before it acts. It clones itself to ~/thc/laptop, next to the app repos.
What it installs
| Name | Description | Type |
|---|---|---|
node | Latest LTS, provisioned by mise | runtime |
mise | Runtime version manager | cli |
direnv | Loads each repo's .envrc (GitHub Packages token from 1Password) | cli |
gh | GitHub CLI | cli |
starship | Shell prompt | cli |
redis | Local Redis for the admin app's cache, started as a login service | service |
libpq | Postgres client tools (psql, pg_dump) | cli |
netlify-cli | Deploys the Netlify-hosted apps | cli |
jq | JSON on the command line | cli |
ripgrep | Fast code search | cli |
ffmpeg | Audio transcoding | cli |
yt-dlp | Song reference downloads | cli |
claude | Claude Code, Anthropic's CLI | cli |
op | 1Password CLI; reads secrets from the vault | cli |
| 1Password | Secrets and the SSH agent | app |
| OrbStack | Docker engine | app |
| Zed | Editor | app |
| Linear | Issue tracker | app |
| TablePlus | Postgres GUI | app |
| Ghostty | Terminal | app |
| Rectangle | Window tiling | app |
It also wires mise, starship, and direnv into ~/.zshrc, and points ~/.ssh/config at the 1Password SSH agent.
After it finishes
In the 1Password app, enable Settings, Developer: Integrate with 1Password CLI, Use the SSH agent, and Touch ID. Then, in a new terminal, sign in, pull the repos into ~/thc, and give each one a .envrc that reads the Packages token from 1Password:
op signin
op document get workspace --vault developer | bash
~/thc/laptop/envrcThen cd ~/thc/admin && npm install && npm run dev. Each repo's README covers its own .env.