GitPedia

Ppl

The command line address book

From henrycatalinismith·Updated May 3, 2026·View on GitHub·

_____ _____ __ | _ || _ || | | __|| __|| |__ |__| |__| |_____| The project is written primarily in Ruby, distributed under the Other license, first published in 2012. Key topics include: address-book, command-line, git, ppl, vcard.

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

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
<a href="https://github.com/henrycatalinismith/ppl/actions/workflows/build.yml"> <img alt="Build status" src="https://github.com/henrycatalinismith/ppl/actions/workflows/build.yml/badge.svg" /> </a>
bash
$ gem install ppl

Usage

List all contacts

bash
$ ppl ls dave: dave@example.org fred: fred@example.org john: john@example.org

Add a contact

bash
$ ppl add paul "Paul Baker"

Show a contact

bash
$ ppl show fred Fred Smith fred@example.org

Delete a contact

bash
$ ppl rm dave

Change a contact's ID

bash
$ ppl mv dave david

Change a contact's name

bash
$ ppl name john "John Smith"

Change a contact's email address

bash
$ ppl email dave david@example.org

Change a contact's birthday

bash
$ ppl bday john 1980-01-01

Contributing

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.

License

ppl is released under the MIT License.

Contributors

Showing top 5 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from henrycatalinismith/ppl via the GitHub API.Last fetched: 6/22/2026