dotfiles

My new, simplified, dotfiles

1. Install the terminal: kitty

   brew install kitty

2. Install Mac package manager: brew

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. You need to make less git! unzip your gcc, catimg jq git-lfs:

   brew install make less git unzip gcc jq catimg git-lfs

4. Install GNU scripts, for better general tools: coreutils

   brew install coreutils

5. Install a better git diff tool: git-delta

   brew install git-delta

6. Install the universal file converter: pandoc

   brew install pandoc

7. Install the prompt: starship

   brew install starship

8. Install the fuzzy-finder: fzf

   brew install fzf

9. Install the smarter cd command: zoxide

   brew install zoxide

10. Install the modern replace for ls: eza

    brew install eza

11. Install the cat replacement (with wings): bat

    brew install bat

12. Install the corn for basic shell commands (the output colorizer): [grc][grc]

    brew install grc

13. Install file colors config generator: vivid

    brew install vivid

14. Install shell syntax highlightning: [fast-syntax-highlighting][fast-syntax-highlighting]

    git clone https://github.com/zdharma-continuum/fast-syntax-highlighting ~/.fsyh

15. Install base completions: zsh-completions

    brew install zsh-completions

16. Install suggestions as you type: [zsh-autosuggestions][zsh-autosuggestions]

    brew install zsh-autosuggestions

17. Install a better completion UI: fzf-tab

    git clone https://github.com/Aloxaf/fzf-tab ~/.fzf-tab

18. Install some premade configs for fzf-tab: [fzf-tab-source][fzf-tab-source]

    git clone https://github.com/Freed-Wu/fzf-tab-source ~/.fzf-tab-source

19. Install the fzf-tab binary module to speed up coloring: ([for reference][fzf-tab-bin-module]):

    build-fzf-tab-module

20. Install the lord of terminal multiplexers: tmux

    brew install tmux

21. Install its package manager: tpm

    git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

22. Install the way to load project sessions into it: [tmux-sessionizer][tmux-sessionizer]

    cargo install tmux-sessionizer

23. Install the searcher: ripgrep

    brew install ripgrep

24. Install the per folder .env file loader: direnv

    brew install direnv

25. Install "FiraCode Nerd Font Mono" from here

26. Install the runtime version manager: mise

    brew install mise

27. Install runtimes for elixir, erlang, rust, python, node, yarn, just and zig:

    mise use -g elixir@latest
    mise use -g erlang@latest
    mise use -g rust@latest
    mise use -g python@latest
    mise use -g node@latest
    mise use -g yarn@latest
    mise use -g just@latest
    mise use -g zig@latest

28. Install neovim

    brew install neovim

29. Install nvim_url:

    git clone https://github.com/kelvinst/nvim_url.git
    cd nvim_url
    make install

30. Install Amethyst

    brew install --cask amethyst

31. Install skhd

    brew install asmvik/formulae/skhd

32. Install JankyBorders

    brew tap FelixKratz/formulae && brew install borders

33. Install ai-jail

    brew tap akitaonrails/tap && brew install ai-jail

34. Install the worktree manager: worktrunk

    brew install worktrunk

35. Install the code formatter: prettier

    npm install -g prettier

36. Install claude code

    curl -fsSL https://claude.ai/install.sh | bash

37. Install claude code acp

    npm install -g @zed-industries/claude-code-acp

38. Install Hammerspoon

    brew install --cask hammerspoon

39. Install the keyboard remapper: Karabiner-Elements

    brew install --cask karabiner-elements

    Open it once and approve what macOS asks for: the driver extension (System Settings → General → Login Items & Extensions) and Input Monitoring for karabiner_grabber and karabiner_observer. Karabiner owns the Caps Lock → Control remap, so leave Caps Lock unmapped in System Settings → Keyboard → Keyboard Shortcuts → Modifier Keys.

40. Clone this repo and run make to install:

    git clone git@github.com:kelvinst/dotfiles.git
    cd dotfiles
    make install

41. Install the hs command-line tool, so Hammerspoon can be driven from a shell instead of its GUI console. It is a symlink into the app bundle — the same one hs.ipc.cliInstall() would make from the console, just pointed at ~/.local/bin (already on PATH) so no sudo is needed:

    ln -sf /Applications/Hammerspoon.app/Contents/Frameworks/hs/hs ~/.local/bin/hs

    It only answers once Hammerspoon is running a config that does require("hs.ipc") — hammerspoon/init.lua here does. Restart Hammerspoon after make install to pick that up, then check it:

    killall Hammerspoon; open -a Hammerspoon; sleep 2; hs -c 'hs.processInfo.version'

42. Make Hammerspoon the default browser, so links open in the Chrome window on the focused aerospace workspace instead of wherever Chrome last had focus. macOS will ask for confirmation:

    hs -c 'hs.urlevent.setDefaultHandler("http")'

    The one call covers https too — Hammerspoon changes both schemes together, so a second command for https would only prompt you again for a change already made.

    This routes every app's links through Hammerspoon, not just one. Undo it in System Settings → Desktop & Dock → Default web browser.

43. Free ⌥F3 for the window hints. alt-f3 drops a letter on every window of the visible aerospace workspaces, on both monitors (accordion stacks flip to tiles while the overlay is up); type a letter to focus that window, or Esc to back out. macOS binds ⌥F3 to Mission Control by default and swallows it before Hammerspoon sees it, so turn that shortcut off (or move it off ⌥F3) in System Settings → Keyboard → Keyboard Shortcuts → Mission Control. Plain F3 stays free for Homerow. Hammerspoon also needs Accessibility permission (System Settings → Privacy & Security → Accessibility).

Feel free to fork and clone it from there. This is under MIT license, do what you want, just give me some credit for it. 😁

• How to uninstall?
  • Just make clean, that's it
• I changed the files in here, how to reinstall?
  • Just run make, it will clean the files in your home and copy them again
• I changed the files in my home dir, how do I copy them here?
  • Just run make update, and we will copy your config files back in here

zsh-autosuggestions tmux-sessionizer fast-syntax-highlighting fzf-tab-source fzf-tab-bin-module grc