dotfiles

Personal shell and CLI configuration files for macOS/Linux users who want a reproducible zsh-first setup.

Overview

This repository contains configuration for zsh, bash (EOS/HPC), git, ssh, vim, nano, bat, starship, lftp, dircolors, and a custom terminfo entry. The default interactive shell setup is zsh, with helper functions and aliases split across modular files under zsh/. Machine-specific overrides belong in zsh/zlocal, which is intentionally gitignored.

Prerequisites

Required:

• zsh
• oh-my-zsh
• git

Optional (configs included in this repo):

• starship
• bat
• lftp
• nano
• vim

Installation

git clone git@github.com:davide-colombo/dotfiles.git ~/dotfiles
cd ~/dotfiles
./install.sh

The installer is idempotent and automatically backs up conflicting existing files to $HOME/.dotfiles_backup/.

Repository Structure

• zsh/: main zsh environment, options, aliases, functions, and terminfo
• eos/: bash configuration for EOS/HPC environments
• git/: git identity/environment templates and local git config slot
• ssh/: SSH config template, env file, and generator script
• vim/: vim configuration
• nano/: nano configuration
• bat/: bat configuration
• starship/: starship prompt configuration
• lftp/: lftp client configuration
• dircolors/: dircolors database
• pmset/: macOS power helper script

Local Overrides

Use zsh/zlocal for machine-specific settings that should not be committed. This file is gitignored and sourced automatically by .zshrc when present.

Example:

# ~/.dotfiles/zsh/zlocal
export PATH="$HOME/custom/bin:$PATH"
alias workproj='cd $HOME/Desktop/my-project'

EOS / HPC

The eos/ directory contains bash files tailored for an HPC workflow. These are not installed by default by install.sh.

License

Released under the MIT License.