happenstance 0.2.1

Happenstance CLI — search your network with AI for sales, hiring, fundraising, and more

happenstance

Command-line interface for Happenstance — search your network with AI. Find warm intros for sales, source referral candidates for hiring, discover investors for fundraising, and research anyone in your network.

Install

# Homebrew (macOS / Linux)
brew tap happenstance-ai/tap
brew install happenstance

# pip
pip install happenstance

# pipx (recommended for CLI tools)
pipx install happenstance

# uv
uv tool install happenstance

Quick start

# Configure your API key (get one at https://happenstance.ai/settings/api)
hpn config set --api-key YOUR_API_KEY

# Search your network
hpn search "CISOs interested in AI in the SF Bay Area"

# Research a specific person
hpn research "https://www.linkedin.com/in/garrytan/"

# Check your credit balance
hpn usage

Commands

Command	Description
hpn config set --api-key KEY	Save your API key
hpn config show	Show saved API key (masked)
hpn search "query"	Search your network
hpn search get ID	Get search results
hpn search find-more ID	Find additional results
hpn research "description"	Research a person
hpn research get ID	Get research results
hpn friends	List your friends
hpn groups	List your groups
hpn groups get ID	Get group details
hpn usage	Show credit balance

Configuration

The API key can be provided in three ways (in priority order):

1. --api-key flag on any command
2. HPN_API_KEY environment variable
3. Config file at ~/.hpn/config.json (set via hpn config set)

All output is JSON and can be piped to jq for processing.

Documentation

Full API docs: https://developer.happenstance.ai