dotfiles

This repository includes all my configuration files.

Usage

Suggested execution order:

# Install homebrew and all the packages listed in the Brewfile
#
# It cannot be done via Taskfile.yaml simply because task CLI has to be installed first
$ ./init.sh

# Install Zim Framework (zimfw)
$ task zimfw

# Deploy dotfiles with stow (typical use case - deployment from scratch)
$ task restow

# Deploy dotfiles with stow (usually used during consequtive runs)
$ task stow

# Install bat themes
$ task bat

# Install mise tools
$ task mise

# Install vale packages
$ task vale

# Install Brave Search CLI (required by the `bx` skill)
$ task bx

# Set up the opencode provider (interactive)
$ opencode providers login

# (Optional step) Sync Brewfile
$ task brewfile

Agent configuration

Some content under opencode/.config/opencode/ is vendored from upstream repositories, declared in vendor.yaml and pinned by commit SHA. Renovate opens a pull request when an upstream moves and CI re-materializes the files on the same branch, so updates always arrive as a reviewable diff.

On a machine git pull is enough for files that changed - they are symlinked into place. Run task stow as well when an update added new ones.

Noteworthy facts

stow's --adapt flag is used to set all the symlinks up. If given file exists in target location (but isn't managed by stow yet) then stow will move it to this repository and configure the symlink afterwards. As a result some unwanted changes may show up here. task restow was introduced to resolve that.

Alfred customizations

Alfred settings get synced through Dropbox that should be enough to set everything up, however just in case here's a list of my customizations:

1. Instruct Alfred to use iTerm2 instead of a built-in Terminal app: link
2. Configure Zoxide integration: link
3. Install Catppuccin themes: link
4. Configure 1Password integration: link
5. Add custom web searches if needed