Skip to content
📓 A tiny script for taking and organizing notes.
Branch: master
Clone or download
Latest commit 2a5a235 Feb 14, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information. Bump version to 0.3.4 and update CHANGELOG Feb 14, 2019 Update EZ Install instructions in README. Aug 3, 2018 Echo successful install in install script. Aug 2, 2018
note Bump version to 0.3.4 and update CHANGELOG Feb 14, 2019


A tiny script for taking and organizing simple text notes.


  • Write a TODO list.
  • Use as a copy/paste clipboard.
  • Make ASCII art. :)

Why use this instead of just typing vim /path/to/my/ ?

  • Type fewer characters.
  • Print a note or print information about a note easily.
  • Open the same note from anywhere.
  • Automatically organizes notes with a sane directory structure.


Note Keeper is a tiny shell script.

EZ Install

Run this command in your terminal:
curl | bash

💡 Get a permission denied error? You might need to run the script with sudo. Try this:
curl | sudo bash

  • ⚠️ Always be careful when using curl | bash to install a program/script. Read through the source code to make sure nothing malicious is happening. This install script is's just 2 lines 😉

Manual Install

  • Simply download the note script file.
  • Place it somewhere nice (like /usr/local/bin/).
  • Make it executable with chmod +x
  • Add it to your path if necessary (e.g. export PATH=$PATH:/usr/local/bin)
  • You can then run the script anywhere by simply typing note at the command line.


  • Running note by itself with no arguments will create a new note file at ~/notes/$year/$month/$ if one does not exist, and will open that note file in Vim.

  • -c | --create

    • Use the -c flag to create a note without opening it.
  • -p | --print

    • Use the -v flag to print the contents of the note.
  • -i | --info

    • Use the -i flag to print information about a note.
  • -e | --edit <Date>

    • ⚠️ Not yet implemented!
    • Use the -e flag with a DATE argument to edit a note from a specific date.
  • -h | --help

    • Use the -h flag to print usage information.



File Organization

$ tree ~/notes
└── 2018
    ├── 07
    │   └──
    └── 08


  • The default editor is set by your $EDITOR environment variable.
    • If no default editor is set, it will use Vim.
      • It opens vim in insert mode.
  • The default location to store notes is in the ~/notes/ directory.
    • To change this, edit the variable $note_path on line 42, and edit the mkdir command in the create_note function, line 5.
You can’t perform that action at this time.