Qingshan's Dotfiles

Dotfiles are for macOS and Linux to setup my development environment.

Install dotfiles, run:

git clone https://github.com/qingshan/dotfiles.git ~/.dotfiles
cd ~/.dotfiles
make

For macOS or Debian desktop, one more step:

make desktop

For AI CLI tools, run:

make ai

Terminal shortcuts: demo alacritty shortcuts

Suitable for all kinds of purpose:

• Desktops
• Development Environments
• Servers/VMs
• Containers

• macOS
• Debian: regolith-i3 & xremap & xmodmap

Both desktops use same key bindings, go to Desktop Cheatsheet.

IDEs:

• IntelliJ IDEA with IdeaVim for Java
• Zed for Rust and Python

Languages:

• Rust: cargo
• Python: uv
• Java: ant, maven
• Nodejs

Containers:

• Apple Container
• Docker

Version Control:

• Git
• LazyGit
• Github CLI

AI:

• Google Gemini CLI
• Github Copilot CLI
• OpenCode

• Debian 13, Ubuntu 24.04
• Rocky Linux 8+, CentOS 8+

• bash
• zsh
• fish

zsh as default shell on macOS:

• ~/.zprofile and ~/.profile is sourced in login shell.
• ~/.zshrc is sourced in interactive shell.

bash as default shell on macOS:

• ~/.bash_profile and ~/.profile is sourced in login shell.
• ~/.bashrc is sourced in interactive shell.

fish as interactive shell in interactive mode of zsh or bash, without setting it as user's default shell.

so update ~/.profile for user environment which will be available for all shells.

Fish shell integration with:

• starship
• fzf
• zoxide
• direnv
• lsd
• bat
• fd
• ripgrip
• jq
• just

• alacritty, ghostty, ssh runs user's default shell as interactive login shell.
• tmux, herdr runs inside an existing shell session, runs fish as interactive non-login shell.
• tmux integrated in alacritty works as default terminal.
• herdr integrated in ghostty works as AI agent terminal.
• ghosttty works as quick terminal.

Both alacritty and ghostty use iTerm2-like key bindings, go to Terminal Cheatsheet.

• ssh server starts interactive login shell.
• ssh server command non-interactive non-login shell.
• echo command | ssh server starts non-interactive login shell. You can also start one with ssh server bash -l -c command.

• Claude Code
• Github Copilot
• OpenAI Codex
• Grok Build

• JetBrains Mono Nerd Font

• zk for cli notes: journal/inbox/notes
• Obsidian for tech notes
• Apple Notes for personal notes
• mdbook for publish notes: qingshan/notes

• ~/work for work projects.
• ~/code for personal projects.
• ~/Documents for cloud sync documents.
• ~/Public for local grouped resources.

• Vim Cheatsheet
• Vim Plugins
• IdeaVim

Use Docker on Linux or Apple container on macOS to build linux/debian/Dockkerfile to test dotfiles on latest version of Debian.

run server test

make server-test

or run desktop test

make deskop-test