whatgotdone VS notes

I wrote a tool specifically for this, mostly inspired by the Snippets tool at Google. I've been publishing my weekly log in it every week for almost three years:

https://whatgotdone.com/michael/2021-12-03

The code is all open source if you're interested in playing around with it:

https://github.com/mtlynch/whatgotdone

I had the same objection to SQLite, and then I heard about Litestream, and it won me over.[0]

Litestream watches your SQLite database and then streams changes to a cloud storage provider (e.g., S3, Backblaze). You get the performance and simplicity of writing SQLite to the local filesystem, but it's syncing to the cloud. And the cool part is that you don't have to change any of your application code to do it - as far as your app is concerned, it's writing to a local SQLite file.

I wrote a little log uploading utility for my business that uses Litestream, and it's been fantastic.[1] It essentially carries around its data with it, so I can deploy my app to Heroku, blow away the instance and then launch it on fly.io, and it pops up with the exact same data.[2]

I'm currently in the process of rewriting an open-source AppEngine app to use SQLite + Litestream instead of Google Firestore.[2] It's such a relief to get away from all the complexity of GCP and Firestore and get back to simple SQLite.

[0] https://litestream.io/

[1] https://mtlynch.io/litestream/

[2] https://asciinema.org/a/I2HcYheYayeh7aHj23QSY9Vyf/embed?size...

[3] https://github.com/mtlynch/whatgotdone/pull/639

I've been doing something similar for ~20 years at: https://github.com/nickjj/notes

    - Running `notes` will open this month's notes for YYYY_MM.txt

I use a very command line focused approach with https://github.com/nickjj/notes.

Since about 2001 I used YYYY-MM.txt plain text files and have a shell script to help create notes in the most friendly way I could think of from the command line at https://github.com/nickjj/notes.

Totally works fine for a knowledge log when you're streaming high level details. I still use it today.

But when you want to really go all-in with in-depth notes it's tricky because in 1 month's time if you're hardcore deep in the woods of learning, applying and using something you're going to end up with hundreds of concepts from an assorted set of tools and it kind of stinks to have all of that info sitting in 1 file. Think about using something like Kubernetes. That's really Kubernetes, Kustomize / Helm, EKS, various cloud hosting details (networking, etc.), Terraform and ton of super useful commands / context. Details you for sure want recorded for later.

For this type of info I've been building up a knowledge base with https://obsidian.md/. It's really nice and I highly recommend it. It's been working well for keeping things reasonably categorized without wasting a lot of time on the details around keeping links and tags up to date. It also has Vim mode that's good enough where day to day writing feels natural.

Did you end up automating the entries?

For example, I have a command line note taking script at https://github.com/nickjj/notes.

It creates a YYYY-MM-DD.txt file and doesn't include time stamps but it would be a 1 line change to make each entry get timestamped. I didn't do that because personally I'm more interested in monthly notes not per minute.

But I do think removing the barrier of creating entries is an important step with jotting things down, this way you can focus on what you want to write and not the boilerplate.

A whole bunch of little things, mainly command line tools.

Most of them are open source and also have extensive documentation and a screencast video going over them.

In no specific order:

- https://github.com/nickjj/notes

- https://github.com/nickjj/invoice

- https://github.com/nickjj/wait-until

And a few recent little scripts to solve specific things:

- https://nickjanetakis.com/blog/using-ffmpeg-to-get-an-mp3s-d...

- https://nickjanetakis.com/blog/a-shell-script-to-keep-a-bunc...

- https://nickjanetakis.com/blog/bash-aliases-to-prepare-recor...

Along similar lines, nickjj also has a similar (but bash) notes script at:

https://github.com/nickjj/notes

While I don't use it personally there's: https://obsidian.md/

It's cross platform and works offline. You write markdown and it produces a visual graph of your data. It supports interlinking notes, tags and images too.

Plain text notes[0] work best for me but I'd probably use Obsidian if I wanted to see things visually. When I tried it out briefly it was really solid.

[0]: https://github.com/nickjj/notes