Secret Party CLI

A terminal UI for managing Secret Party events.

Installation

Quick Install (macOS/Linux)

curl -sSL https://raw.githubusercontent.com/wevans997-dev/secretparty-cli/main/install.sh | sh

Go Install

If you have Go installed:

go install github.com/wevans997-dev/secretparty-cli/cli/cmd/secretparty@latest

Note: The binary will be named secretparty. Rename it to sp if you prefer:

mv $(go env GOPATH)/bin/secretparty $(go env GOPATH)/bin/sp

Download Binary

Download the latest release for your platform from the Releases page.

Platform	Download
macOS (Apple Silicon)	sp_*_darwin_arm64.tar.gz
macOS (Intel)	sp_*_darwin_amd64.tar.gz
Linux (x64)	sp_*_linux_amd64.tar.gz
Linux (ARM64)	sp_*_linux_arm64.tar.gz
Windows	sp_*_windows_amd64.zip

Build from Source

git clone https://github.com/wevans997-dev/secretparty-cli.git
cd secretparty-cli/cli
go build -o sp ./cmd/secretparty
./sp

Features

• Authentication: Login with email/password, credentials stored securely in system keychain
• Event Management: View all your events with status, ticket counts, and revenue
• Event Details: See ticket type breakdown, sales stats, and attendee lists
• Attendee Management: View attendees sorted alphabetically, paginated display
• CSV Export: Export attendee lists to CSV files
• Event Creation: Step-by-step wizard to create new events with ticket types

Usage

Run the CLI:

sp

Navigation

Key	Action
↑/↓	Navigate lists, move between wizard steps
←/→	Page through attendees, select options
Enter	Select, confirm, advance to next step
Esc	Go back
e	Export to CSV (on event detail screen)
Ctrl+C	Quit

Event Creation Wizard

The wizard guides you through creating an event:

1. Event Name - Required
2. URL Slug - Auto-generated from name, editable
3. Description - Optional
4. Start Date & Time - Required, must be in future (format: YYYY-MM-DD HH:MM)
5. End Date & Time - Required, must be after start time
6. Venue - Optional
7. Location - Optional (address, city, state)
8. Capacity - Optional
9. Privacy - Choose: private, semi-private, or public
10. Ticket Types - Add one or more ticket types with name, price, and quantity
11. Review - Confirm and create

Use ↑ to go back and edit previous steps.

Security

• Credentials are stored in your system's secure keychain (macOS Keychain, Windows Credential Manager, or Linux Secret Service)
• If keychain is unavailable, falls back to ~/.config/secretparty/credentials.json with restrictive permissions (0600)
• Auth tokens are JWT format and expire; re-login if you see authentication errors

Shell Scripts

For quick command-line access without the TUI.

Setup

Get your auth token from the browser:

1. Login at https://www.secretparty.io
2. Open DevTools (F12) → Console
3. Run: localStorage.getItem("token")
4. Export: export SP_TOKEN="your-token"

get_invitations.sh

Fetch invitations for an event:

./get_invitations.sh [event_id]

export_purchasers.sh

Export ticket purchasers to CSV:

./export_purchasers.sh [event_id]

API Documentation

See AGENTS.md for detailed API reverse-engineering notes.

License

MIT