Skip to main content

pen: terminal notes

Project description

pen: terminal notes

pen is a minimalistic note taking app for the command line.

PyPI Version Build Status PyPI License PyPI Python Versions Say Thanks!

What is this?

With pen you can have notes everywhere. At least on every unix machine. What makes it special is that it is “only“ a command line application. Therefore you can even run it on your own server. Pen has a minimalistic interface; notes can be added and grouped in a simple manner.

Pen Terminal


It's as simple as that:

$ pip install penpal

Unfortunately "pen" was already taken.


pen all - List all notes recursively.

pen create <list> - Create a list.

pen delete <list> (<note>) - Delete a list or note.

pen help - Display help information.

pen help <command> - Displays help for a command.


pen stores all its data (with zlib compression) in the file ~/.pen. You are free to do whatever you want with this data, it is yours after all. This is helpful, if you want to keep your notes synchronized over multiple computers. Move the data file over to your Dropbox folder for example.

You can also change the path of the storage file:

pen path <path> - Either prints the current storage path or sets a new one.

So go out there and hack some code!


  • Minimalistic and simple note editor.
  • Automatic saving when closed.
  • Create lists to group notes.
  • Put the storage file wherever you want. (Supports Dropbox & co.)


Fork and contribute!

For questions and suggestions, feel free to shoot me an email at

Also, follow or tweet @cwoebker.

Copyright (c) 2013-2018, Cecil Woebker. License: BSD (see LICENSE for details)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

penpal-0.5.0.tar.gz (8.2 kB view hashes)

Uploaded source

Built Distribution

penpal-0.5.0-py2.py3-none-any.whl (7.8 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page