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.

Files for penpal, version 0.4.2
Filename, size File type Python version Upload date Hashes
Filename, size penpal-0.4.2-py2.py3-none-any.whl (6.8 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size penpal-0.4.2.tar.gz (7.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page