First time startup

On the first use you will be asked to point gojot to a repository. You will also be able to select which editor you’d like to use. Currently only four editors are supported: micro, vim, emacs, and nano. All released versions of gojot (2.0.0+) include micro built-in.

Adding an entry

Adding an entry is as simple as starting the program and selecting the document to put the entry in.

Here is a simple example of adding an entry:

Each entry is assigned a random name. The random name is only used to keep track of things internally, but you can also use the name to quickly edit a specific entry. To do this, simply delete the randomized entry name and type in your own.

Then, to edit a specific entry, simply type in the entry name after running the program:


You can delete whole documents, or single entries. In both cases you just name the item you want to delete.


Deleting is permanent! All files locally and remotely will be deleted.

Here is an example for deleting a document:

And here is an example of deleting an entry:


Its often useful to see old entries, which you can edit as well. To load the whole document, simply add the flag –all. Or you can simply select y when prompted about loading the whole document.

Here is an example of loading a whole document:


You can import prevoius gojot journals using import.

--importold (DayOne importing)

You can import a DayOne type journal using –importold.


You can export your whole document as a text-file using the –export flag. Here is an example:


If you’d like to get information about wordcounts and entry counts in all your documents, simply use the –stats flag:


With the –config flag you can change the repository that is being used and the editor that is being used.


With the –clean flag you can erase all the gojot folders. This includes the cache of currently known git repositories, $HOME/.cache/gojot, as well as any configuration files in $HOME/.config/gojot. You will be prompted to verify that this is what you want.


All entries can be succintly summarized using the –summary flag. This will show the date, the entry name, number of words, and then the first few words in the entry.

Here is an example:


If you have any problems at all, please submit an Issue and someone can help you sort it out.