Shard Detail

notor v1.5.3

note-taking terminal app

Install & Use

Add the following code to your project's shard.yml under:

dependencies to use in production
- OR -
development_dependencies to use in development

  github: vexe141/notor



A simple terminal-based app that you can use to take and store short notes.


Follow the following instructions to build and install the app.

Install Crystal and Shards (Crystal's package manager) first to build the app.

Then, clone the repo.

git clone

Go into the directory and build and install as follows.

cd notor
shards install
make release
sudo make install

By default, the binary will install to the path /usr/local/bin. To change that, change the final sudo make install command to sudo make INSTALL=<path> install where you replace <path> with the install path of your choice.


If you installed the app using make, an uninstall script named is created automatically. You can simply run that script to uninstall notor, or run sudo make uninstall in the source directory, both will do the same thing.

If you do not have the uninstall script, possibly due to installation without make, you can remove the binary named notor directly from the install path, and remove the hidden folder .notor in the home directory if you want to delete your notes and configuration as well.


You can run notor --help to get a guide to the basic usage for the app. While using notor, you generally run the executable along with some subcommand, optional flags and arguments. A few common subcommands that you'll find yourself using include:

  • new: Takes the title and content of the note as arguments and creates a new note.
  • cat: Takes the title of an existing note as an argument and displays it's content.
  • del: Takes the title of an existing note as an argument and deletes the note.
  • list: Lists the notes currently existing.


  1. Fork it (
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new pull request


  • vexe - creator and maintainer