dotfiles

A collection of my personal dotfiles and configuration settings for development tools, designed for easy setup and consistent experience across different machines.

NeoVim Screenshot

• 2026-01-05
  • neovim: Nightfox theme
  • ghostty: Nightfox theme

How to setup dotfiles on a new system

Prerequisites

• macOS
• Homebrew is installed
• aqua (You can manually install it by brew install aqua)
• Your .zshrc will be installed and configured to point to your global aqua.yaml (e.g., via AQUA_GLOBAL_CONFIG)
• Oh-my-zsh is installed
  • https://ohmyz.sh/#install

🛠️ Note: aqua and your .zshrc can be set up automatically by this setup process.

Manual Setup Required

Git Configuration

Before running the setup script (make gitconfig or make all), edit dotfiles/git/.gitconfig.local to include your personal Git settings (e.g., user name and email). This file will be copied to your home directory as ~/.gitconfig.local during the setup process.

tpm(tmux plugin manager)

https://github.com/tmux-plugins/tpm

Claude Code

claude code

git push policy

• git push is not allowed by default (Claude asks for confirmation).

• To allow it in a repository, add the following to .claude/settings.local.json there:

  {
    "permissions": {
      "allow": ["Bash(git push *)"]
    }
  }

• Even when allowed, the PreToolUse hook claude/hooks/block-protected-push.sh always blocks pushes to protected branches (main, master, develop, release, release/*) and force pushes other than --force-with-lease.

• The hook parses command strings, so it cannot catch pushes via sh -c or git aliases. Use branch protection on the remote as well.

• Run bash claude/hooks/test-block-protected-push.sh to test the hook.

Usage

Clone the repository to your home directory

cd
git clone git@github.com:yyossy5/dotfiles.git
cd dotfiles

Run setup

Full setup

make

Partial setup

e.g., Setup .zshrc only

make zsh

Show avaliable make commands

make help

⚠️ Settings Note

brew

Sometimes, not everything gets installed properly with a single brew install.

In such cases, you can rerun it with make brew.

How to add dotfiles to this repository

You can add new dotfiles to this repository by following these steps:

1. Copy or move the config file into the appropriate directory For example, to add your ~/.gitconfig:

mkdir -p ~/dotfiles/git
cp ~/.gitconfig ~/dotfiles/git/.gitconfig

2. Update setup.sh to create a symbolic link

Edit setup.sh and add a new install_gitconfig() function if it doesn't already exist:

install_gitconfig() {
    log "Setting up gitconfig..."
    backup_and_link "$HOME/.gitconfig" "$DOTFILES_DIR/git/.gitconfig"
}

Also, update the main() function to support this target:

gitconfig) install_gitconfig ;;

3. Add a Makefile target

gitconfig: ## Install .gitconfig
 ./setup.sh gitconfig

4. Test it

make gitconfig

Check that the symlink is created and the config works as expected.

Configs in this repo but not installed by the setup script

The following configuration files are included in this repository but are not managed by the setup script, as they are not the kind that can simply be placed somewhere on the local machine to be automatically loaded.

• bettertouchtool

Archived configs

Configs for tools that are no longer in use are kept in archive/. See archive/README.md for details.

Tools that are not managed by dotfiles

Raycast

Raycast pro plan can manage the settings via cloud sync.

Reference

• https://github.com/neovim/nvim-lspconfig/blob/master/doc/configs.md#ruff

Past NeoVim/iTerm2 Screenshots

• 2025-12-28
  • neovim: everforest theme
  • ghostty: Everforest Dark Hard theme

• 2025-04-09
  • neovim: carbonfox theme
  • iTerm2: Oxocarbon theme

• vscode theme

• Nightfox theme

• everforest theme