The command line address book
Fetching latest commit…
Cannot retrieve the latest commit at this time.

 _____  _____  __
|  _  ||  _  ||  |
|   __||   __||  |__
|__|   |__|   |_____|

ppl aims to be address book software for command-line users. It's pronounced like "people". You might be interested in ppl if:

  • You like using the command-line
  • You want ownership of your address book data back from the cloud
  • You prefer to keep your data stored in an open format

Build Status Code Climate


$ sudo gem install ppl


List all contacts

$ ppl ls

Add a contact

$ ppl add paul "Paul Baker"

Show a contact

$ ppl show fred
Fred Smith

Delete a contact

$ ppl rm dave

Change a contact's ID

$ ppl mv dave david

Change a contact's name

$ ppl name john "John Smith"

Change a contact's email address

$ ppl email dave

Change a contact's birthday

$ ppl bday john 1980-01-01


Bug reports, fixes, and additional features are encouraged. The project uses Github issues to track bug reports.

Everyone interacting in ppl’s codebases, issue trackers etc is expected to follow the code of conduct.


ppl is released under the MIT License.