_ __   ___  ___ _ __  ___
| '_ \ / _ \/ _ \ '_ \/ __|
| |_) |  __/  __/ |_) \__ \
| .__/ \___|\___| .__/|___/
|_|             |_|

Quick access to your macOS contacts from the command line.

Requires

MacOS

Install

Option 1: Download pre-built binary (recommended)

Download the latest release from GitHub Releases, then:

chmod +x peeps
sudo mv peeps /usr/local/bin/peeps

Option 2: Build from source

swift build --configuration release
sudo cp -f .build/release/Peeps /usr/local/bin/peeps

Usage

Fetch all your contacts matching "jen":

$ peeps jen

If only one match is found, peeps will display it:

Found 1 peep.

Jenny Schneider
---------------
iPhone  (555) 867-5309
Other   (555) 606-0842

Work    jenny8675309@gmail.com

Home    1234 Main St
        Anytown, CA 12345

If multiple matches are found, peeps will display a list of matches for you to choose.

Found 3 peeps.

1. Jenny Schneider
2. Jennifer Universal
3. Ron O'Jen

Who to peep? [1-3]: _