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.

Filename, size & hash SHA256 hash help File type Python version Upload date
penpal-0.4.2-py2.py3-none-any.whl (6.8 kB) Copy SHA256 hash SHA256 Wheel py2.py3
penpal-0.4.2.tar.gz (7.7 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page