Dotfiles Setup Guide

Personal dotfiles and configuration scripts for macOS, WSL, and development tools. Automate your environment setup and keep your configs in sync across machines.

---

Table of Contents

• Overview
• Prerequisites
• Setup Instructions
  • macOS
  • Windows Subsystem for Linux (WSL)
  • General Configs
• VSCode Setup
• Troubleshooting
• Additional Settings
• Recommended Chrome Extensions

---

Overview

This repository contains scripts and configuration files to quickly set up a development environment on macOS or Windows (WSL). It includes shell scripts, system preferences, VSCode settings, and more.

Prerequisites

• git

Note: The following tools are automatically installed by the setup scripts:

• Homebrew (for macOS)
• tmux
• VSCode
• Other development tools and dependencies

Setup Instructions

macOS

1. Run the main setup script:

   bash ./install/mac.sh

2. Install tmux plugins:
   • In a tmux session, press prefix (Ctrl + t) then I (capital i)

Windows Subsystem for Linux (WSL)

1. Enable WSL in "Turn Windows features on or off"
2. Install Ubuntu and Windows Terminal from Microsoft Store
3. [Optional] Set up DNS configs if you have connectivity issues:
   • No internet connection on WSL Ubuntu
   • No write permissions on a file even with sudo
4. Clone and set up dotfiles:

   git clone https://github.com/keiohtani/dotfiles.git && cd dotfiles && source install/wsl.sh

5. Configure Windows Terminal:
   • Open settings and add to your Ubuntu profile:

     "colorScheme": "Solarized Dark",
     "fontSize": 9

6. Install tmux plugins:
   • In a tmux session, press prefix (Ctrl + t) then I

General Configs

• Set up configs (applies to both macOS and WSL):

  source install/configs.sh

VSCode Setup

See vscode/README.md for recommended extensions and settings.

Troubleshooting

• Increase memory and CPU limits for WSL2
• Custom npm registry for coc.nvim

macOS — Full Disk Access (TCC)

Some of the macOS setup scripts copy files from protected locations under ~/Library (Contacts, Mail, Messages, and other system preferences). If you see errors like:

cp: /Users/kohtani/Library/Preferences/com.apple.AddressBook.plist: Operation not permitted

that means the process doing the copy is blocked by macOS privacy (TCC). To fix this:

1. Open System Settings → Privacy & Security → Full Disk Access (System Preferences → Security & Privacy → Privacy → Full Disk Access on older macOS).
2. Add the terminal app you use (Terminal.app, iTerm, or Visual Studio Code) to the list and unlock to allow changes.

Additional Settings

• Git Credential Manager (for WSL):

  git config --global credential.helper "/mnt/c/Users/kohtani/AppData/Local/Programs/Git/mingw64/bin/git-credential-manager.exe"

• Azure DevOps Only:

  git config --global credential.https://dev.azure.com.useHttpPath true

Recommended Chrome Extensions

• Grammarly
• 1Password
• Vimium