@localpulse/cli

CLI for Local Pulse — ingest event posters, search events, and manage credentials.

Install

Via bunx (zero-install):

bunx @localpulse/cli --help

Global install:

bun add -g @localpulse/cli
localpulse --help

See the package on npm.

Quick start

# Authenticate
localpulse auth login --token lp_cli_...

# Search upcoming events
localpulse events search "techno amsterdam"

# Search with filters
localpulse events search "festival" --date weekend --tz Europe/Amsterdam

# Include past events
localpulse events search "amsterdam" --all

# Structured JSON output
localpulse events search "berlin" --json

# Publish an event in one shot (audit blocks on warnings)
localpulse events publish event.json poster.jpg

# Create a draft without publishing (publish later from the web editor)
localpulse drafts create event.json poster.jpg

# Lint a draft JSON offline (schema + editorial audit, no network)
localpulse drafts lint event.json

Commands

auth login

Authenticate with a CLI token. Get one at localpulse.nl/dev.

auth logout

Remove stored credentials.

events publish <event.json> <poster.jpg> [extras…]

Publish an event to Local Pulse from a structured JSON + poster (image or video). Runs schema validation, the editorial quality audit (audit findings BLOCK publish; non-music events declare is_music_event: false in the JSON to skip the music-specific gates), uploads media, creates + publishes the draft, and prints the live event URL. Pass --dry-run to validate without uploading.

drafts create <event.json> <poster.jpg> [extras…]

Same upload pipeline as events publish, but leaves the draft at ready status so you can review and publish it later from the web editor. Audit findings are printed as warnings but do NOT block creation.

drafts lint <event.json>

Offline schema + editorial audit — no network. Useful before running events publish.

drafts list, drafts delete <id>, drafts schema

Manage drafts and print the JSON Schema for the event-input payload (drafts schema; pass --field <path> for a single fragment).

events search <query>

Search upcoming events by default. Supports --city, --date today|weekend|upcoming, --tz, --all (include past), --json, --limit, --cursor.

events edit <poster_id>

View or update fields on a published event. Supports --set key=value (repeatable), --dry-run, and --json.

All commands support --json for structured, machine-parseable output.

Environment variables

| Variable | Purpose | |----------|---------| | LP_TOKEN | Override stored token | | LP_API_URL | Override API URL (default: https://localpulse.nl) |

License

MIT