English | 日本語 | 中文

Development environment setup scripts for macOS, Ubuntu, and WSL. Select and install only the feature blocks you need via an interactive menu.

Clone and run the interactive installer in one command:

curl -fsSL https://raw.githubusercontent.com/long-910/dotfiles/main/install.sh | bash

To install everything non-interactively:

curl -fsSL https://raw.githubusercontent.com/long-910/dotfiles/main/install.sh | bash -s -- --all

The repository is cloned to ~/.dotfiles. Set DOTFILES_DIR to override the location:

DOTFILES_DIR=~/my-dotfiles curl -fsSL https://raw.githubusercontent.com/long-910/dotfiles/main/install.sh | bash

Select feature blocks from an interactive menu.

git clone https://github.com/long-910/dotfiles.git
cd dotfiles
bash bootstrap.sh

All-in-one installer. For environments where bootstrap.sh is unavailable.

git clone https://github.com/long-910/dotfiles.git
cd dotfiles
chmod +x install_and_configure.sh
./install_and_configure.sh

Toggle ON/OFF by entering numbers when bootstrap.sh starts. Non-interactive execution is also available:

bash bootstrap.sh --all                 # All blocks
bash bootstrap.sh --module shell        # Single module
bash bootstrap.sh --non-interactive     # Auto with defaults
bash bootstrap.sh --list                # List modules

tmux starts automatically when you open a new terminal and attaches to the most recent existing session, or creates a new one. Closing tmux also exits the shell. To disable, remove ~/.zshrc.d/tmux.zsh.

WSL2 — icons not displaying? lsd uses Nerd Fonts for file-type icons. On WSL2 the terminal runs on Windows, so the font must be installed on the Windows side:

1. Download a Nerd Font (e.g. CaskaydiaCove Nerd Font, JetBrainsMono Nerd Font) from nerdfonts.com
2. Right-click the .ttf file → Install for all users
3. In Windows Terminal: Settings → your Ubuntu profile → Appearance → Font face → select the installed font (e.g. CaskaydiaCove Nerd Font Mono)
4. Restart the terminal

Edit config/starship.toml to customize. After installation, it is placed at ~/.config/starship.toml.

Create .envrc in your project root:

export DATABASE_URL="postgresql://localhost/myapp"
export NODE_ENV="development"

direnv allow   # Required on first use

Quickly scaffold projects with the newproject function:

newproject node  my-app      # Node.js project
newproject python my-script  # Python project

Store API keys and environment-specific settings in ~/.zshrc.local (not committed to git).

cp dotfiles/.zshrc.local.example ~/.zshrc.local
# Edit ~/.zshrc.local with your editor

See Doc/en/secrets.md for details.

bash uninstall.sh

• Removes deployed files from ~/.zshrc.d/
• Restores backups of .zshrc, .tmux.conf, .emacs.el
• Removes ~/.config/starship.toml and ~/.config/atuin/config.toml
• Removes git commit.template setting
• Optionally removes installed packages

• tmux
• zsh
• Tools
• Secrets Management
• emacs | htop | neofetch | yazi

MIT — See LICENSE for details.