Skip to content


Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time


These are my dotfiles. Take anything you want, but at your own risk.

It mainly targets macOS systems, but it works on at least Ubuntu as well.


  • Minimal efforts to install everything, using a Makefile
  • Mostly based around Homebrew, Caskroom and Node.js, latest Bash + GNU Utils
  • Great Window management (using Hammerspoon)
  • Fast and colored prompt
  • Updated macOS defaults
  • Well-organized and easy to customize
  • The installation and runcom setup is tested weekly on real Ubuntu and macOS machines (Big Sur and Monterey; Catalina should still be fine too) using a GitHub Action
  • Supports both Apple Silicon (M1) and Intel chips

Packages Overview


On a sparkling fresh installation of macOS:

sudo softwareupdate -i -a
xcode-select --install

The Xcode Command Line Tools includes git and make (not available on stock macOS). Now there are two options:

  1. Install this repo with curl available:
bash -c "`curl -fsSL`"

This will clone or download, this repo to ~/.dotfiles depending on the availability of git, curl or wget.

  1. Alternatively, clone manually into the desired location:
git clone ~/.dotfiles

Use the Makefile to install everything listed above, and symlink runcom and config (using stow):

cd ~/.dotfiles

The installation process in the Makefile is tested on every push and every week in this GitHub Action.


  • dot dock (set Dock items)
  • dot macos (set macOS defaults)
  • Mackup
    • Log in to Dropbox (and wait until synced)
    • ln -s ~/.config/mackup/.mackup.cfg ~ (until #632 is fixed)
    • mackup restore

The dotfiles command

$ dot help
Usage: dot <command>

    clean            Clean up caches (brew, npm, gem, rvm)
    dock             Apply macOS Dock settings
    edit             Open dotfiles in IDE (code) and Git GUI (stree)
    help             This help message
    macos            Apply macOS system defaults
    test             Run tests
    update           Alias for topgrade


To customize the dotfiles to your likings, fork it and make sure to modify the locations above to your fork.


Many thanks to the dotfiles community.