marcus-crane / dotfiles

My dotfiles

dotfiles

View my dotfiles in literate form at dotfiles.utf9k.net

This repository contains my dotfiles which are shared between my home and work machines which consist of both macOS and Linux devices.

I have more macOS devices than Linux but I aspire to keep the installation as seamless as possible between the two.

In saying that, this repository definitely has some sharp edges so while you're welcome to take whatever from it, do note that there are no guarantees of anything working or being easy to use.

Chezmoi is my dotfile manager which both manages files as well as runs some pre and post-installation scripts to install dependencies, programming languages and libraries that I use day to day.

I have a wonky (read: gross) language manager abstraction visible in .chezmoidata.yaml which selectively installs different language runtimes depending on whether the machine is used for home or work.

Currently I use mise to manage languages and previously used asdf for quite a few years.

My shell of choice is zsh, with oh-my-zsh although from time to time I flip between OMZ and raw zsh as I don't really use many features from it.

Installation

On a fresh machine, it's supposed to be possible to both install chezmoi and my dotfiles in one go like so:

sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply marcus-crane

I say supposed to because I don't set up machines from scratch very often, and each time I do, there's usually some bootstrapping problem like hard references to chezmoi that don't resolve, because it isn't installed yet where my shell scripts expect it to be.

As mentioned, there's no guarantee that this repo will be easy to set up, as it's not intended for others to be running day to day.

A note on tangling files

You may notice that some configuration files are seemingly missing with .md files in their place.

This is because a few, and in time most of, my config files are kept as "literate configuration".

In short, all of the surrounding commentary is stripped and the correct file is generated off of the source code blocks.

In order to "tangle" them into a proper config, I use lugh, a hacky custom made tool for tangling markdown that I made one day to play with crystal. It's just sort of stuck around so I haven't had any reason to deprecate it but there are probably better tool for this sort of thing.

I have used Emacs org-tangle for this job and it's nice but it's also quite a bit of overhead to get it running. Generally on a new machine, compiling Emacs can take quite some time.

Anyway, lugh should be installed automatically as part of the initial chezmoi apply so with that, you can "tangle" the file you're interested in like so:

lugh -f <file>

A working example would be:

lugh -f zshrc.md
# Wrote /Users/marcus/.local/share/chezmoi/dot_zshrc.tmpl

Instead of anything fancy, I just "tangle" the contents into a file that chezmoi expects and since it's a .tmpl file, it can also make use of chezmoi's built in variables.

Extras to be manually installed

• Wallpaper - evangelion-clock-screensaver
• Font - JetBrainsMono Nerd Font Regular 14

dotfiles's Issues

Set up a pre-preinstall script

There are some prerequisites that need to happen before chezmoi init can be done, such as installing Homebrew, wget, XCode command tools

Git repository too good??

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

This repository currently has no open or pending branches.

Detected dependencies

bun

package.json

• vitepress ^1.0.0-rc.45
• typescript ^5.0.0

github-actions

.github/workflows/deploy.yml

• actions/checkout v4
• oven-sh/setup-bun v1
• cloudflare/pages-action v1
• mshick/add-pr-comment v2
• ubuntu 22.04

.github/workflows/shellcheck.yml

• actions/checkout v4

---

• Check this box to trigger a request for Renovate to run again on this repository

Suggestion: use `onepasswordDocument` to simplify `~/.ssh/config`

Hi, I saw your tweet about using 1Password and specifically these lines:

https://github.com/marcus-crane/dotfiles/blob/main/dot_ssh/config.tmpl#L12-L16

chezmoi has a onepasswordDocument template function which I use and might allow you to simplify your code. In my case, I keep my work-specific SSH config in a 1Password Document and insert it into ~/.ssh/config directly.

Hope this helps, and of course close the issue if it's not relevant.