The command line address book

Try it!

$ ppl add henry "Henry Smith"
$ ppl phone henry 012345678
$ ppl email henry henry@henrysmith.org
$ ppl show henry
Henry Smith <henry@henrysmith.org>

Email Addresses:

Phone Numbers:


ppl is free software made out of other free software. It's built on top of Ruby and Git, and the completely free vcard address book format.


ppl is built on top of Git, the world's most popular decentralized version control system. Use your address book wherever you like and let Git worry about making sense of it all.


ppl does its best to be a proper UNIX-style comand line program. Proper exit codes, no superfluous output, that sort of thing.

Latest Version

2.4.0 (2016-01-12)

Better commit author

Get Involved! 2015-12-03

The time has come to give this project a nudge into a slightly different mode of operation. Enough people are interested in the long term health of this little CLI app that I think it’d benefit from opening the doors a bit to potential collaborators and maintainers. So I’ve converted the project into a proper GitHub organization and I’m inviting you to come and join it.

I see lots of people come and go with great ideas for this project. I love 99% of the ideas and suggestions that pop up but I just can’t keep up with all the different demands on my time. That’s the bottleneck that’s holding the project back and it’s silly, really.

For a while I’ve been wanting to do something about this. If you want to help out in any way, however small, speak up on GitHub, email me, or get in touch on Twitter. I’d love to add you to the organization and let you just get started making your ideas happen. Even if you just like the project, but don’t have any immediate plans to do anything in particular, that’s fine! If you’ve never contributed to an open source project before, don’t let that put you off. Everyone’s welcome!