I do dotfiles

These are my dotfiles used on both Arch and Mac. I use chezmoi to manage them.

Install

First install chezmoi: install chezmoi

Then run:

chezmoi init --apply https://github.com/sandepten/dotfiles.git

Tools I use

• Neovim
• Tmux
• Zsh
• eza (ls replacement)
• yazi (TUI file manager)
• fzf (fuzzy finder)
• bat (cat replacement with syntax highlighting)
• zoxide (cd command replacement)
• atuin (command line tool for remembering and suggesting commands)
• niri (scrollable wayland compositor)
• ghostty
• starship

Agent guidance (when editing this repo)

This repo is the chezmoi source for personal dotfiles used on Arch Linux and macOS.

Repo shape

• dot_* entries map to paths in $HOME.
• Most config lives under dot_config/, especially nvim, hypr, niri, tmux, kitty, ghostty, bat, btop, yazi, and starship.
• Shell setup is centered around dot_zshrc.tmpl, dot_zsh/, dot_profile, and dot_gitconfig.
• dot_config/nvim/ has its own README.md; dot_config/opencode/ is bundled agent/skill content, not core machine config.

Chezmoi conventions

• dot_: becomes a dotfile or dot-directory in the target home directory.
• private_: private/sensitive content; treat carefully and avoid committing secrets.
• executable_: installed with the executable bit.
• .tmpl: Go template source. Keep template syntax valid. Two keys are required and are referenced directly rather than through a hasKey guard, so a machine missing them fails with the key name instead of rendering a silently different shell: is_work and default_node_agent.
• .chezmoiignore is also templated. Its entries are destination-relative, so .config/hypr and not dot_config/hypr. A source-relative entry matches nothing and is dropped without warning.
• .new files are alternate/reference configs and deploy as separate files with the .new suffix.
• private_ templates reference their values from [data] in the local ~/.config/chezmoi/chezmoi.toml rather than storing them here, so no PAT enters this repository. missingkey=error makes a machine that has not set them fail loudly.

Required local config

chezmoi init on a new machine stops with map has no entry for key "is_work" until these are set. Create ~/.config/chezmoi/chezmoi.toml (mode 600) before the first apply:

[template]
  options = ["missingkey=error"]

[data]
  is_work = false
  default_node_agent = "npm"

is_work gates the corporate TLS workaround, the OMZ snippet skip, and the Azure DevOps credential file. default_node_agent is what ni uses. A work box also needs ADO_ORG, ADO_ORG_URL, ADO_PROJECT, ADO_PROJECT_ID, ADO_PAT, and ADO_PAT_RW; a personal box does not, because the credential template renders empty and chezmoi then creates no file.

Theming

The default is catppuccin, in two layers.

On Linux, omarchy owns the palette. Terminals import ~/.local/state/omarchy/current/theme/, neovim and starship follow omarchy theme set, and btop and kitty read the generated files. Set the active one with omarchy theme set catppuccin. The omarchy installer seeds "Tokyo Night" on a fresh machine, so run that once after install.

On macOS there is no omarchy, so the values are stated in the source: theme = "Catppuccin Mocha" in the ghostty config, --theme="Catppuccin Mocha" in bat, @catppuccin_flavor "mocha" in tmux, catppuccin mocha syntax themes for yazi, and the catppuccin nvim colorscheme as the neovim fallback.

Editing notes

• Prefer editing the chezmoi source here, then verify with chezmoi diff and apply with chezmoi apply.
• Be careful with OS-specific branches in templates so Linux and macOS behavior do not drift accidentally.
• Hyprland is the omarchy layout. dot_config/hypr/hyprland.lua loads omarchy defaults then your monitors, input, bindings, looknfeel, and autostart modules. Omarchy reads hypr/ from your config directory at login, so a new file needs a matching require line here.
• dot_zsh/path.zsh.tmpl contains work-only Node/npm TLS relaxations; do not broaden them casually.
• dot_zshrc.tmpl has a marked chezmoi managed toolchain region. CLI installers append PATH lines inside those markers. An installer appending outside them will be deleted by the next apply.
• Shell startup is pinned by an equivalence harness. Before changing path.zsh, zinit.zsh or zshrc, capture the shell state and diff it, and re-check startup timing. A change that only removes a subprocess is worth more than one that adds structure.

Note: Home ~/AGENTS.md is not managed by chezmoi (HCMP agent standing policy). Do not re-add AGENTS.md to this source.