ref: 9ccc8779f3633e66a7352a68ecfd2b77fdca785e t/README.md -rw-r--r-- 2.8 KiB
9ccc8779 — Pedro Lucas Porcellis Add command to share notes at a given provider 9 months 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 rather 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 indexed by it's modification date, while piping to the default PAGER on your system (usually less (1)).

  • create or c will create a new note using the current date. You can supply a title in quoted strings

  • edit or e will reopen the note on your EDITOR, by default it will edit the last one. You can supply the index of the note 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 distros etc). After that, you can use make get to fetch all dependencies and start hacking!

Send your patches to my public-inbox at ~porcellis/public-inbox@lists.sr.ht

(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 UI app tw


Under terms of the GNU GPL-3.0 License. Check LICENSE.