~/dotfiles

Dotfiles for Arch Linux and macOS, managed with dots.

Screenshots

Fresh machine

Clone the repo and run the bootstrap script:

git clone git@github.com:phcurado/dotfiles.git ~/dotfiles
cd ~/dotfiles
./setup.sh

setup.sh will basically install dots, which manages dotfiles declaratively and works on both my Linux and macOS setups. You can install dots first and check the changes that will be made on your machine with dots check.

If you're running Arch, it's good to reboot after running the scripts because the setup changes the shell (bash to zsh), creates groups, and starts system services.

Daily use

Whenever I change something or create symlinks, I just run:

dots check

This shows which settings from these dotfiles will be applied on the machine. To apply them:

dots apply

I use different profiles on the same machine. For instance, I have different VPN configurations depending on the project I'm working on, so I can quickly switch profiles with these commands:

dots --profile personal apply
# no VPN service

dots --profile work apply
# Twingate

dots --profile company apply
# Tailscale

Dotfile Setup

• shell: zsh
• config links: Neovim, Ghostty, tmux, zsh, Starship, git, yazi, bat, btop, mise, zoxide
• fonts from fonts/
• mise tools
• local commands such as pi, tree-sitter, weather, and tpane

Arch resources include:

• pacman bootstrap packages: base-devel, git
• paru installed through pacman
• desktop packages for niri/noctalia
• user groups: docker, wheel
• system services: Bluetooth, Docker, NetworkManager
• profile services: Twingate for work, Tailscale for company

macOS resources include:

• Homebrew and Homebrew taps
• AeroSpace, SketchyBar, Borders, Ghostty, Brave, Discord, Obsidian, Docker Desktop, Tailscale, 1Password
• SketchyBar Lua bindings
• Homebrew services for SketchyBar and Borders

Makefile

The Makefile is only a shortcut layer:

Command	Description
make secrets.backup	Print AGE key for backup

Notes

macOS window management

Before using AeroSpace for the first time, turn off Displays have separate Spaces in System Settings > Desktop & Dock > Mission Control, then log out and back in. Grant Accessibility permissions to AeroSpace and SketchyBar when prompted. If I remember correctly, you will get prompted for all this configuration when setting up these dotfiles.

Niri keybindings

Key	Action
Super + T	Terminal
Super + B	Browser
Super + Space	App launcher
Super + Q	Close window
Super + Tab	Previous workspace
Super + M	Power menu
Super + Alt + L	Lock screen
Super + Ctrl + W	Random wallpaper
Print	Screenshot

Secrets

The SOPS AGE key is restored from 1Password by dots apply.

You can backup using the make command.

make secrets.backup

AI - pi.dev

I'm using Pi as my agent harness. It is very customizable and fits nicely into my workflow. You can check my plugins and configuration in the .pi/ folder.

Tmux

Tmux is a terminal multiplexer and probably one of the most important tools in this setup. Since I work on many projects, I create tabs and specific workflows for how things should be opened to improve my experience while coding. I also created my own tool to manage tmux panes: tpane, which allows me to configure tmux using Lua. This tool also keeps a daemon running that stores pane state in memory and allows me to customize how and when things should be opened using the shortcuts in .config/tmux/tpane/. Here are some of them:

Key	Action
Super + c	New tab
Super + a	Open or toggle pi pane in the right
Super + t	Open or toggle a pane terminal in the bottom

Disclaimer

This is my personal configuration. The intent of this project is not to be copied, but to serve as inspiration for anyone who wants to use similar tools or just check my config.