WAAAGH's Linux Dev Env

What's in this repo

Desktop & Terminal

• DE: KDE Plasma configs
• Wayland desktop: Niri + Noctalia v5, Tokyo Night palette, Omarchy wallpaper, dual-monitor layout and native idle locking — setup guide
• Terminal: Alacritty (installed via mise, with a locally managed desktop entry) + Cosmic Term configs
• Terminal multiplexer: tmux configs
• Terminal multiplexer: zellij (auto-installed)
• Shell prompt: Starship configs
• Shell: Zsh (with Oh My Zsh) + Bash
• File manager: Yazi (auto-installed)
• Font: monospace font set to Monaspace Nerd Fonts (auto-installed)

AI Coding Agents (all via Bitwarden secret injection)

• Claude Code — mise run cc
• OpenCode — mise run oc
• Pi — mise run pi
• Codex CLI — mise run codex
• Antigravity CLI — mise run agy

Dev Tools (managed by mise)

• Languages: Python 3.13, Node 24, Go, Rust (latest)
• Package managers: uv, bun
• CLI tools: k9s, ripgrep, GitHub CLI, rtk
• Web: vibe-kanban, @termly-dev/cli
• Skills: skillshare for cross-tool AI skill sync

Dotfile management: chezmoi

• External tools auto-installed: mise, oh-my-zsh, monaspace fonts, skillshare, lazyssh, yazi, zellij
• Alacritty desktop entry: local chezmoi template using the stable mise shim, independent of the compositor's PATH
• Encryption: age-encrypted files for personal tokens

Other

• Agent configs: GSD (~/.gsd), Pi (~/.pi)
• Rust: Cargo config (~/.cargo)
• X11: ~/.Xresources, ~/.xinitrc, ~/.xprofile
• SSH & OpenClaw (private dirs)

Niri / Noctalia notes

• The monitor layout targets this machine: DP-1 at 3840×2160 / 150% scale, with HDMI-A-1 rotated 90° on the right. Adjust connector names and geometry on other machines.
• Super+T opens Alacritty; Super+D opens the Noctalia application launcher. Alacritty launches through the mise shim because a graphical session may not inherit shell PATH settings.
• Noctalia handles notifications; the managed user-service mask disables mako to prevent competing notification daemons. The mako package is not uninstalled.
• Niri and Noctalia must already be installed. See the desktop guide for first-apply state overrides, lockscreen testing and rollback details.

Screenshot

How to install

Quick start

• Install git and fontconfig which are used in the process below

For Debian/Ubuntu users:

apt install git fontconfig zsh curl
apt install cmake g++ pkg-config libfontconfig1-dev libxcb-xfixes0-dev libxkbcommon-dev python3
sh -c "$(curl -fsLS get.chezmoi.io)" -- -b $HOME/.local/bin

• Then initialize and apply the configuration:

chezmoi init pkking
chezmoi apply

Recovery from another device

• install deps

apt install git fontconfig zsh curl
apt install cmake g++ pkg-config libfontconfig1-dev libxcb-xfixes0-dev libxkbcommon-dev python3
sh -c "$(curl -fsLS get.chezmoi.io)" -- -b $HOME/.local/bin

• recover age key

mkdir -p ~/.config/chezmoi
# 将私钥内容写入 key.txt，并设置严格的文件权限
nano ~/.config/chezmoi/key.txt
chmod 600 ~/.config/chezmoi/key.txt

• place chezmoi age key config in ~/.config/chezmoi/chezmoi.toml

# cat ~/.config/chezmoi/chezmoi.toml
encryption = "age"
[age]
    identity = "~/.config/chezmoi/key.txt"
    recipient = "age1..." # 你的公钥（可选配置，解密阶段主要依赖 identity）

• init dotfiles

chezmoi init --apply pkking

Install tmux plugins by pressing Ctrl + a and Shift+i

Now all tmux plugins will be installed on a new machine due to this tip

Handle sensitive data

• Encrypt a file with sensitive data:

chezmoi add --encrypt <path to file>

• Re-encrypt all files when adding a new public key:

chezmoi re-add --encrypt

Feel free to email me or create an issue.

Have fun :)