README.md

My Dotfiles

There are my personal dotfiles. They are managed using:

CLI

• direnv: Securely loads or unloads environment variables depending on the current directory.
• Homebrew for macOS package management.
• Homesick for managing dotfiles.
• Just 🤖 Just a command runner.
• Starship The minimal, blazing-fast, and infinitely customizable prompt for any shell.

GUI

• Alfred: Productivity tool and Alfred Powerpack.
• Hammerspoon: An macOS automation tool (tiling windows manager)

Python

• pip: The PyPA recommended tool for installing and managing Python packages.
• pyenv: Simple Python version management.
• uv: An extremely fast Python package installer and resolver, written in Rust.

Installation

1. Bootstrap our environment (install uv)

$ just bootstrap

Justfile Usage

$ just --justfile=./home/justfile

Available recipes:
    bootstrap                                 # installs/updates all dependencies
    cleanup DAYS="0"
    fmt                                       # format and overwrite justfile
    freeze                                    # Updates our lockfiles without installing dependencies
    lock                                      # alias for `freeze`
    git-commit-msg
    homebrew-services
    install
    kill-tabs                                 # Kill all Chrome tabs to improve performance, decrease battery usage, and save memory.
    open-docs
    open-go
    open-ha
    open-syncthing
    outdated
    pip-install *ARGS
    pip-uninstall *ARGS
    postgresql-upgrade
    pyenv-upgrade +ARGS="--skip-existing"
    pyenv-upgrade-all +ARGS="--skip-existing"
    python-update
    restart
    stop
    update                                    # updates a project to run at its current version
    upgrade
    upgrade-all
    uv-python-install *ARGS
    uv-python-reinstall *ARGS
    uv-tool-install *ARGS
    llm ...
    macos ...
    ollama ...
    virtualenv ...
    virtualenvwrapper ...

Hammerspoon Keyboard Shortcuts

Action	Key Combination
hyper	ctrl + opt + cmd
meta	cmd + shift
reload config	hyper + r
show grid	hyper + g
make full screen	hyper + m
center and 60%	hyper + c
move to left half	hyper + left
move to right half	hyper + right
move to top half	hyper + up
move to lower half	hyper + down
move to upper left (25%)	ctrl + opt + shift + left
move to upper right (25%)	ctrl + opt + shift + up
move to lower left (25%)	ctrl + opt + shift + down
move to lower right (25%)	ctrl + opt + shift + right
move to next monitor	ctrl + opt + right
move to previous monitor	ctrl + opt + left

Terminal theme

• Dracula Dark theme for iTerm and 294+ apps.

Inspiration / Thank you!

• The Geeky Way: What are dotfiles?
• https://github.com/epicserve/dotfiles
• https://github.com/geerlingguy/mac-dev-playbook
• https://github.com/JohnColvin/.maid/blob/master/rules.rb
• https://github.com/mathiasbynens/dotfiles/blob/master/.osx
• https://github.com/mitchty/src/blob/master/dotfiles/maid/rules.rb
• http://blog.palcu.ro/2014/06/dotfiles-and-dev-tools-provisioned-by.html

Contact / Social Media

Here are a few ways to keep up with me online. If you have a question about this project, please consider opening a GitHub Issue.