Minimal journaling CLI for developers. Just type journal
in your terminal and start writing.
journalot
is a CLI tool for maintaining a daily markdown journal with Git-based version control. It's designed to be lightweight and easy to use, promoting mindfulness and reflection.
You can also search past entries by keyword or date using command-line tools like grep or fzf. For example, grep "confidence" or "new idea" ~/journalot/*.md
- Creates a daily journal file:
YYYY-MM-DD.md
- Opens it in VS Code
- Auto-commits and pushes to your private or public GitHub repo
- Works across multiple devices
- Promotes mindfulness through lightweight journaling
git clone git@github.com:jtaylortech/journalot.git
cd journalot
sudo ./install.sh
Make sure you have SSH access set up for GitHub. Guide
By default, this repo points to my public GitHub. To push your own journal entries:
- Create a new private repo on GitHub (e.g.,
journalot-private
) - Replace the remote:
git remote remove origin
git remote add origin git@github.com:<your-username>/journalot-private.git
git push -u origin main
journal
You can modify the journal directory or change editors (e.g. nano
, vim
) by editing the bin/journal
script.
This project is licensed under the MIT License - see the LICENSE file for details.