dotfiles-etc

Code for setting up a software workstation. Config files are currently tracked for the following programs:

• bash

• git

• neovim

• powershell

• starship

• tmux

• vscode

• zsh

Portable env vars, PATH entries, and aliases shared between bash and zsh live in a single ~/.profile (dotfiles/profile/.profile); see dotfiles/README.adoc for how the shells wire it in. That file also carries PATH/env setup for third-party tools that self-register into shell config on their own — Homebrew (brew shellenv) and the Obsidian CLI (Obsidian > Settings > General > Command line interface) both do this, and folding their setup into .profile is what makes it apply to both shells instead of just whichever one the tool’s installer happened to touch.

Installing

There is a work-in-progress Rust binary in the ./tools directory for installing config files. Use the alias cargo install-cfgs to run the setup script from the workspace root.

Potential additions

• Automated Neovim tests

  • https://github.com/nvim-mini/mini.nvim/blob/main/readmes/mini-test.md

  • https://github.com/nvim-lua/plenary.nvim

• SQLite utilities

• Python

  • PDM

  • UV

• GPG (or GPG4Win)

• Sigstore Cosign

• Terraform / OpenTofu / Terragrunt

• Installing rust-based tools globally with cargo

  • https://crates.io/crates/tree-sitter-cli

• Install iTerm via Homebrew

• Install Docker Desktop via Homebrew

• Install hadolint via Homebrew

• Docker autocompletion via /Applications/Docker.app/Contents/MacOS/com.docker.admin

• cspell-cli

• LateX

  • MacTeX

Tools to investigate

• Snagit: Cross-platform snipping tool ($40/yr)

• markup-based presentations

  • https://github.com/slidevjs/slidev

  • https://marp.app/

Issues

• vim.tbl_add_reverse_lookup is deprecated