dotfiles

このリポジトリは、macOS のローカル端末環境と SSH 接続先の Ubuntu 環境で、できるだけ同じシェル操作感を再現するための dotfiles を管理するものです。

主に zsh、starship、eza、uv、補完設定、alias / function 類を Git で一元管理し、OS 依存の差分は分離したまま共通化します。

展開には GNU Stow を使い、必要な設定だけをホームディレクトリへ安全に反映する方針です。

GNU Stow 前提の最小構成です。zsh/ パッケージをホームディレクトリへ展開し、macOS と Ubuntu でできるだけ同じ操作感を維持します。

Structure

• ghostty/.config/ghostty/config macOS ローカルで使う Ghostty の設定です。
• zellij/.config/zellij/ macOS ローカルで使う zellij の設定です。
• zsh/.zshrc 共通設定、OS 別設定、ローカル差分を順に読み込むエントリポイントです。
• zsh/.config/zsh/common.zsh 補完、alias、upm()、Starship 初期化などの共通設定です。
• zsh/.config/zsh/macos.zsh Homebrew や Antigravity など macOS 固有の PATH 設定です。
• zsh/.config/zsh/linux.zsh ~/.local/bin など Linux 側の PATH 設定です。
• ~/.zshrc.local Git 管理しないローカル差分です。

macOS

Initial setup

前提として Homebrew が入っていることを想定しています。

brew install starship eza uv zsh-autosuggestions stow && \
git clone git@github.com:kanalsop/dotfiles.git ~/dotfiles && \
cd ~/dotfiles && \
stow zsh ghostty zellij zed

反映後は新しいシェルを開くか、現在のシェルで次を実行します。

exec zsh

Ghostty の設定は stow ghostty 実行後に Ghostty を再起動するか、Ghostty の設定リロードを実行して反映します。

Update

cd ~/dotfiles && \
git pull && \
stow zsh ghostty zellij zed && \
exec zsh

Ubuntu

Ghostty, zellij, zed はローカル端末側の責務なので、Ubuntu サーバー側では設定しません。

Initial setup

starship、eza、uv は環境によって導入方法が複数ありますが、ここでは apt で入るものは apt、それ以外は公式インストーラを使う想定です。

sudo apt update && \
sudo apt install -y zsh stow git curl unzip gpg zsh-autosuggestions

• starship のインストール

curl -sS https://starship.rs/install.sh | sh

• uv のインストール

curl -LsSf https://astral.sh/uv/install.sh | sh

• eza のインストール

sudo mkdir -p /etc/apt/keyrings && \
curl -fsSL https://raw.githubusercontent.com/eza-community/eza/main/deb.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/gierens.gpg && \
echo "deb [signed-by=/etc/apt/keyrings/gierens.gpg] http://deb.gierens.de stable main" | sudo tee /etc/apt/sources.list.d/gierens.list > /dev/null && \
sudo chmod 644 /etc/apt/keyrings/gierens.gpg /etc/apt/sources.list.d/gierens.list && \
sudo apt update && \
sudo apt install -y eza

その後、このリポジトリを配置して設定を反映します。

git clone git@github.com:kanalsop/dotfiles.git ~/dotfiles && \
cd ~/dotfiles && \
stow zsh

zsh をログインシェルにする場合は次を実行します。

chsh -s "$(which zsh)"

反映後は再ログインするか、現在のシェルで次を実行します。

exec zsh

Update

cd ~/dotfiles && \
git pull && \
stow zsh && \
exec zsh

Local-only settings

他のマシンと共有しない設定は各マシンで ~/.zshrc.local に定義します。

References

• https://zenn.dev/108_twil3akine/articles/mac-setup-263