The simplest note taker

1a554c8 Display notes using the user's pager

~porcellis pushed to ~porcellis/t git

a month ago

7dacd4e Display notes using the user's pager

~porcellis pushed to ~porcellis/t git

a month ago


t is an minimalistic tool to take notes.


Instead of using a web editor or some native app that under the hood is a web page, or even a fully bloated app to take your notes and store it on someone elses server with their proprietary software and APIs we choose to use something way more simple, a combination of two very well documented, free and trusted tools: git and markdown.


t is designed to be completely simple and out of your way. Especially when taking notes, sometimes all you want is somewhere to drop a bunch of thoughts.

When writing a note, t will open your EDITOR (we recommend vim). As soon that you write all you need and quit the app, t will push your note to the configured git server. That's it.


t has a small set of commands:

  • list or l will list your notes by it's modification date
  • create or c will create a new note using the current date. You can supply a title in quoted strings
  • edit or e will edit a note, by default it will edit the last one. You can supply a position of the index you want to edit.
  • show or s will pipe the note to glow

You can check the man page man t if you need any help.


For now, you can only install by cloning this repository and running the installation script.

So open your favorite terminal and fire these commands:

  • git clone https://git.sr.ht/~porcellis/t
  • make && sudo make install

If you have any interest in packaging this software to your distro of choice, please let me know, so I can update the steps here.

Note: By now, the show commands depends on glow to be installed.


The plain, good and old git-way of contributing.

The only dependency is go, which you can install trough your package manager (apk on Alpine, pacman on Arch, apt on Debian-based etc). After that, you can use make get to fetch all dependencies and start hacking!

Send me your patches to my email at pedrolucasporcellis@gmail.com

(Remember to use plain text)!


There's a lot of things I want to implement on t, here is some of them:

  • Add a improved visualization when displaying notes
  • Support OS Pager when listing notes (this can be achieved by t list | less -r)
  • Delete a note
  • Make setup through t (t init would create the notes repository, set a remote, etc).
  • Add PGP support for notes (this is a must)
  • Allow editing by title of note
  • Companion app tw


GNU GPL v3 License. Check LICENSE.