linux dot files

The macOS terminal on Arch Linux and Raspberry Pi OS, set up with one command per machine

Quick start · How it works · What lives where · Tools · Daily use

---

What you get

This is the same shell as macos-dot-files: Zsh with Sheldon, a Catppuccin Starship prompt, tmux with TPM, LazyVim, Atuin history, and the modern CLI replacements (eza, bat, delta, zoxide, fzf, btop and more). It runs on two machines:

Machine	OS	CPU	RAM	Storage	Arch
Beelink SER9 MAX	Arch Linux	Ryzen AI 7 350 (Radeon 860M)	64 GB DDR5-5600 (32 GB reserved for the GPU)	1 TB NVMe	x86_64
Raspberry Pi 5	Raspberry Pi OS (64-bit)	Cortex-A76	8 GB	2 TB NVMe	arm64

Both screenshots were taken over SSH from Ghostty on the Mac, which renders the fonts and colours. The fastfetch layout is the Mac's own config; only the logo differs per machine.

---

Quick start

On a fresh Arch or Raspberry Pi OS (64-bit, Debian 13 "trixie" based) install, run:

sh -c "$(curl -fsLS get.chezmoi.io)" -- -b ~/.local/bin init --apply seifscape/linux-dot-files

That command does five things:

Step	What happens	Where
1	Asks for your git name and email, which are stored locally and never committed, and the machine role: dev (default on Arch) or server (default elsewhere)	.chezmoi.toml.tmpl
2	Installs zsh, tmux, git and build tools with pacman (Arch) or apt (Raspberry Pi OS), and makes zsh the login shell	run_once_before_10-base-packages.sh
3	Installs mise into ~/.local/bin	run_once_before_20-install-mise.sh
4	Writes the dotfiles and pulls the shared ones from macos-dot-files	.chezmoiexternal.toml.tmpl
5	Runs mise install, sheldon lock and bat cache --build	run_onchange_after_30-mise-install.sh.tmpl

Then finish two things by hand:

exit                 # log back in so zsh becomes your shell
tmux                 # then press prefix + I to install tmux plugins

Warning

Use a trixie-based Raspberry Pi OS. On a Debian 12 "bookworm" image, atuin's prebuilt binary needs glibc 2.38+ and fails at every shell start (bookworm ships 2.36).

Tip

Unauthenticated GitHub API calls are capped at 60 per hour, and a dev machine has 31 tools to resolve (a server has 26). If mise install stops on a rate limit, export GITHUB_TOKEN=… and run chezmoi apply again.

---

How it works

This repo holds only the files that have to differ on Linux. Everything else comes straight from macos-dot-files as a chezmoi external. Each shared file has one real copy, and nothing has to be synced by hand.

flowchart LR
    subgraph mac["macos-dot-files · main"]
        direction TB
        A[".aliases · .functions<br/>.exports · .zsh_bindings"]
        B["tmux · starship · nvim<br/>atuin · btop · delta"]
    end
    subgraph linux["linux-dot-files"]
        direction TB
        C[".zshrc · .zprofile · .gitconfig"]
        D["mise tools · sheldon plugins"]
        E["pacman/apt + mise bootstrap"]
    end
    U["upstream<br/>tpm · catppuccin themes"]
    mac -- "tarball, refreshed daily" --> S
    linux -- "chezmoi source" --> S
    U -- "git / raw, weekly" --> S
    S(["chezmoi apply"]) --> M["Beelink SER9 MAX"] & P["Pi 5"]

Loading

Edit a shared file on the Mac and push it. The next chezmoi update on each server picks it up.

---

What lives where

Linux only (in this repo)

File	How it differs from the Mac
.zshrc	Runs mise activate first, because mise provides sheldon, zoxide, atuin and starship here; activates fnox and aube only where they're installed
.zprofile	Puts mise shims on PATH instead of running brew shellenv; no OrbStack or VS Code
.zshenv	Puts ~/.local/bin on PATH, where mise installs itself
.gitconfig	Leaves out the Sourcetree difftool and Git Credential Manager
.gitconfig.local	Created once from your init answers, then left alone
mise/config.toml	The CLI tools Homebrew provides on the Mac, plus the Mac's runtimes on a dev machine
fastfetch/logo.txt.tmpl	The logo for the shared fastfetch config (pulled from the Mac): a Catppuccin-gradient Arch logo, or on a Pi the Raspberry Pi logo, since trixie-based Raspberry Pi OS reports itself as plain Debian. Sources live in .chezmoitemplates/fastfetch/
~/.zshrc.local	Not in the repo. .zshrc sources it if present, for one machine's aliases and checks (the Pi's docker and Tailscale bits)
ghostty/config.ghostty	Linux-only Ghostty keys on top of the shared config: Super+K clears the screen and scrollback, Super+T opens a tab, like ⌘K and ⌘T on the Mac. Ghostty loads both files
sheldon/plugins.toml	Loads fzf with fzf --zsh instead of from /opt/homebrew/opt/fzf
.claude/settings.json	Not a copy: merges two keys into Claude Code's own file and keeps the rest. statusLine shows the claude-code profile from starship.toml, as the Mac's install.sh does with jq. env.DISABLE_AUTOUPDATER leaves updates to mise, the way Homebrew owns them on the Mac; otherwise Claude Code's updater reinstalls itself under ~/.local/share/claude, leaving two copies

Shared (pulled from macos-dot-files)

Shell	.aliases · .functions · .exports · .zsh_bindings
Terminal	Ghostty config · .tmux.conf · tmux.reset.conf · starship.toml
Editor	the whole ~/.config/nvim directory (LazyVim)
Tools	atuin · btop · delta · gh-dash · fastfetch · dev-updates.sh
Git	.gitignore_global

Upstream (replaces the Mac's manual clones)

Target	Source	Refresh
~/.tmux/plugins/tpm	tmux-plugins/tpm	weekly
~/.config/delta-themes	catppuccin/delta	weekly
~/.config/bat/themes/	catppuccin/bat: Frappé, Latte, Mocha	weekly

---

Tools

Debian's apt is missing most of these tools or ships old versions, and mise has native builds for both architectures, so both machines get them from mise even though Arch's repos have them.

What gets installed depends on the role chosen at chezmoi init (stored as role in ~/.config/chezmoi/chezmoi.toml; machines set up before roles existed default to dev on Arch and server elsewhere). To switch, run chezmoi init again or edit that file, then chezmoi apply.

	dev (SER9 MAX)	server (Pi 5)
Terminal tools, including Claude Code	✅	✅
uv, fnox, node	✅	✅
python, go, zig, rust, aube	✅	—

A server never compiles anything, so the other runtimes would only be weekly re-downloads from dev-updates.sh. uv still gets you Python on demand (uv run, uv tool install). Node stays because the Pi runs Node scripts.

Runtimes

The same pins as the Mac, with three differences: ruby and tuist are left out, and python.compile is off because it would build Python from source.

Tool	Pin	Role		Tool	Pin	Role
uv	0.11.6	both		fnox	latest	both
python	3.14.3	dev		node	24.19.0	both
go	1.24.2	dev		rust	latest	dev
zig	0.11.0	dev		aube	latest	dev

Note

On a server, the tmux-thumbs hint mode (prefix + Space) can't install: it compiles with Rust, and its prebuilt binaries are x86_64 only. Pressing it just opens a pane with an error. Use copy mode (prefix + [), which reaches the Mac clipboard over OSC 52.

Terminal tools (all latest)

sheldon   starship  zoxide    atuin     fzf       eza       bat
delta     fd        ripgrep   jq        btop      duf       dust
procs     tealdeer  superfile fastfetch neovim    lazygit   gh
claude    lazydocker

From pacman / apt: zsh tmux git curl wget tree ncdu base-devel / build-essential, plus JetBrains Mono Nerd Font, the Mac's Ghostty font, for a local terminal (over SSH the Mac draws the fonts): ttf-jetbrains-mono-nerd from pacman on Arch, and the nerd-fonts release into ~/.local/share/fonts on the Pi

---

Daily use

Task	Command
Pull changes from both repos	chezmoi update
Get a Mac-side change right now	chezmoi apply --refresh-externals
Edit a Linux-only file	chezmoi edit ~/.zshrc, then chezmoi apply
Preview what would change	chezmoi diff
Upgrade every mise tool	dev-refresh
Edit a root-owned file (/opt/stacks/…, /etc/…)	sudoedit <file> — never sudo nvim
Put Neovim plugins back on the pinned versions	nvim --headless "+Lazy! restore" +qa

Warning

sudo nvim runs Neovim as root inside your home folder, so its undo history, plugin checkouts and caches under ~/.local/share/nvim, ~/.local/state/nvim and ~/.cache/nvim become root-owned and break later updates. sudoedit (or sudo -e) edits a temp copy in your own Neovim — EDITOR=nvim comes from the shared .exports — and only the save runs as root. Likewise prefer Lazy! restore over Lazy! sync: the lock file comes from the Mac.

Important

Edit shared files on the Mac, in macos-dot-files, and push them. If you edit ~/.aliases on a server, the next refresh overwrites it.

To try a Mac branch before merging it, point the externals at that branch:

chezmoi apply --refresh-externals --override-data '{"macosRef":"my-branch"}'

Keeping shared files portable

Everything listed under Shared runs on both systems, so follow these rules when editing on the Mac:

Instead of	Use
a macOS-only alias	the [[ $OSTYPE == darwin* ]] block at the bottom of .aliases
pbcopy	clip, which uses pbcopy on the Mac and OSC 52 over SSH and inside tmux
/Users/seifkobrosly/…	$HOME
stat -f, sed -i ''	zstat, or another form that works on both BSD and GNU

---

Structure

linux-dot-files/
├── .chezmoiroot                       # source lives in home/, which keeps README out of $HOME
├── screenshots/                      # sirius.png · nebula.png, for this README
└── home/
    ├── .chezmoi.toml.tmpl             # git name/email prompts · macosRef
    ├── .chezmoiexternal.toml.tmpl     # shared files + tpm + catppuccin themes
    ├── .chezmoitemplates/fastfetch/   # Arch + Raspberry Pi logos for logo.txt.tmpl
    ├── .chezmoiscripts/
    │   ├── run_once_before_10-base-packages.sh
    │   ├── run_once_before_20-install-mise.sh
    │   └── run_onchange_after_30-mise-install.sh.tmpl
    ├── .chezmoiremove                 # old files to delete: Oh My Zsh, the native claude install, …
    ├── create_dot_gitconfig.local.tmpl
    ├── dot_gitconfig
    ├── dot_zprofile
    ├── dot_zshenv
    ├── dot_zshrc
    ├── dot_claude/
    │   └── modify_settings.json       # merges statusLine + DISABLE_AUTOUPDATER into Claude Code's settings
    └── dot_config/
        ├── fastfetch/logo.txt.tmpl    # per-machine logo; config.jsonc comes from the Mac
        ├── ghostty/config.ghostty     # Linux-only keys, loaded next to the Mac's config
        ├── mise/config.toml.tmpl      # tool list, by role
        └── sheldon/plugins.toml

Credits

The tmux setup and the Ghostty starfield shader (both shared from macos-dot-files) come from omerxx/dotfiles, including the catppuccin-tmux, tmux-sessionx and tmux-floax plugins. Colours: Catppuccin.

---

Companion to macos-dot-files · Catppuccin everywhere