my-software

My personal software: dot files, utility programs, setup instructions, and more.

Overview

The most impactful component of this repository might be my macOS Setup notes. It provides step-by-step instructions I like to follow for setting up a new Mac. In this repository, I've also crammed in a wide range of other personal tooling I've developed or am just experimenting with.

mac-os/

My personal instructions for configuring macOS the way I like it and installing the tools I use.

See the README in mac-os/.

bash/

My Bash config and notes about Bash auto-completion (I always forget how to set this up!).

See the README in bash/.

homebrew/

A description of my Homebrew strategy.

See the README in homebrew/.

java/

Java code that supports my personal workflows.

See the README in java/.

javascript/

JavaScript code that supports my personal workflows.

See the README in javascript/.

jetbrains/

My configuration for JetBrains IDEs (e.g. Intellij and Android Studio).

Essential tools for software developers and teams

https://www.jetbrains.com

See the README in jetbrains/.

karabiner/

My configuration for the amazing tool Karabiner-Elements https://github.com/tekezo/Karabiner-Elements.

Karabiner-Elements is a powerful utility for keyboard customization on macOS Sierra or later.

-- https://github.com/pqrs-org/Karabiner-Elements

nushell

My Nushell configuration and scripts.

See the README in nushell/.

vscode/

My Visual Studio Code user settings and keybindings.

See the README in vscode/.

starship/

My config file for Starship.

The minimal, blazing-fast, and infinitely customizable prompt for any shell!

-- https://github.com/starship/starship

Wish List

General clean-ups, TODOs and things I wish to implement for this project:

• [ ] Consider restoring (at b3154dde and before) the shortcuts I had defined for navi (but no need to use navi). There was some good knowledge there, but I never wound up using navi.
• [ ] Consider restoring (at b3154dde and before) my usage of markdownlint. I still like it, but I just never got used to using it. learn them better. I think I should pare down the larger one-liners.
• [ ] Consider restoring (at b3154dde and before) my Postgres-related Bash functions. These were hard fought and useful. Maybe reimplement in Nushell. Alternatively, I often use Postgres in Docker. But still. (Same is true of the Mongo functions but not sure how much I'll ever use Mongo again.)
• [ ] I really want quick, keyboard-based diff review like I have in Intellij. See https://github.com/microsoft/vscode/issues/24389
• [ ] I want enhanced (LLM) search over my browser history. Safari somehow clobbers entries in my history, or at least they don't show up. It's almost like it consolidates multiple pages for the same host or something. For example, as I explore a new topic I'll look at official docs which are often scattered across multiple subsets of pages because of marketing reasons and/or the natural sprawl of a volunteer-driven project. Some of these pages are golden, but hard to discover. If I've found them once, then I want to find them again. Maybe I should use bookmarks/read-later more. Whatever it is, consider this story again. Apache Iceberg (and the branching into Hive stuff) is a good example of this.
• [ ] (aspirational) Finetune an LLM on parsing/extracting my TODO/WishList items. They aren't fully machine readable because of formatting differences and also I use different words sometimes (DONE, SKIP, HOLD, and I might make something up) so they aren't perfectly classifiable by keyword. I think this is a pretty good candidate for a low-parameter model which I can run on my computer. I would just start

... View full README on GitHub