My Personal Journaling System

Published May 20, 2019 · 425 words · 2 minute read

Perhaps the most valuable thing I’ve done for myself in recent months is beginning to write daily, about my life and my thoughts, in a critical and introspective way. This post is about the tools I have developed to make journaling quick and accessible from any machine.

{: .center-image }

Above is the latest iteration of the je tool, which is now public and open source. . Since I’m always near a command line, I decided to build tools that allowed me to quickly add entries and view the journal in its entirety. Running the je command adds a timestamp and opens a new vim instance to the bottom of the daily entry. To view entries, I run jv, which builds the journal (now in a tenth of a second thanks to Hugo,) and opens it in a web browser.

When I first began writing digital journal entries, I wrote unnecessarily complex shell scripts that added entries to a private path on my github site. These scripts were run daily by my bot . With this system, I had to go back and remove empty entries manually. I scripted this pruning process after becoming fed up with removing days, sometimes weeks, of empty entries by hand. After moving out and losing my ability to automate from home, I refactored my je (journal-entry) script to only write entry files when I began writing a timestamped entry. This removed the need for both automation and the removal of empty entries.

Time passed, and my GitHub academic credentials expired. This meant my public sites served from private repositories would be shuttered. To keep my personal site up and running, I’d have to strip all the private data and re-upload it in a public repository. This presented me with an excellent opportunity to re-write my journaling tools, which I took .

Writing this tiny program for myself has taught me plenty about the evolution of developer tools: There’s always a better, faster, more complex, or less complex way to accomplish a task. It’s up to you, the developer, to choose the correct language and tools to complete the task while keeping your optimization priorities in mind.

No matter what tools you use, I cannot recommend daily journaling enough. To write well is to think clearly,1 and there is no better thing to think about for self and societal improvement than your daily life, the people around you, your current circumstances, and your potential future paths.

Thanks for reading,


  1. David McCullough, during an interview with NEH chairman Bruce Cole. ↩︎