RayTerm

An opinionated, reproducible coding environment across Linux, macOS and Windows.

What is this?

A set of dotfiles + a package manifest that, in one command, gives you:

• Tiling window management on every OS — Hyprland (Linux), AeroSpace (macOS), GlazeWM (Windows).
• Coherent keybindings across all three (mapped to SUPER on Linux/Windows, Alt on macOS).
• Terminal-first stack — xonsh + tmux + Neovim (LazyVim) + Ghostty.
• Rose-Pine theming everywhere — GTK / Qt (Kvantum) / KDE / terminal.
• AI-native — Claude Code, Ollama, LM Studio, opencode wired in.
• Everything managed by chezmoi — declarative, reproducible, one-line bootstrap.

Quick install

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

Or manual:

# 1. Install chezmoi
sh -c "$(curl -fsLS get.chezmoi.io)"

# 2. Apply
chezmoi init --apply https://github.com/rayanramoul/dotfiles

Stack at a glance

Layer	Linux (Arch / CachyOS)	macOS	Windows
Window manager	Hyprland	AeroSpace	GlazeWM
Status bar	Noctalia	SketchyBar (+ JankyBorders)	GlazeWM bar
Launcher	Vicinae	Raycast	Wox
Terminal	Ghostty	Ghostty	Alacritty / Windows Terminal
Shell	xonsh + Starship + Atuin + Carapace	same	same (via WSL)
Editor	Neovim (LazyVim)	same	same
Multiplexer	Tmux (rose-pine theme)	same	same
File manager	Yazi (TUI) / Dolphin (GUI)	Yazi / Finder	Yazi / Explorer
Lock / idle	Hyprlock + Hypridle	—	—
Wallpaper	swww (via wallpaperctl.sh)	—	—
Notifications	SwayNC + Noctalia	native	native
Screenshots	grim + slurp + satty	Shottr	—
Theme	Rose-Pine (GTK / Kvantum / KDE / Terminal)	same	same

CLI tools available everywhere: bat, lsd, fzf, ripgrep, fd, zoxide, atuin, starship, just, git-delta, difftastic, lazygit, lazydocker, btop, tealdeer, glow, dive, topgrade, fastfetch, onefetch, presenterm, mise.

Keybindings

Open the live cheatsheet anytime with SUPER + / (renders via glow in a floating Ghostty).

Apps & system

Key	Action
SUPER + Return	Open terminal (Ghostty)
SUPER + Q	Kill focused window
SUPER + Space	Launcher (Vicinae)
SUPER + Ctrl + E	Emoji picker
SUPER + E	File manager (Dolphin)
SUPER + V	Toggle floating
SUPER + F	Toggle fullscreen
SUPER + P	Pin / unpin active window
SUPER + /	Open this cheatsheet
SUPER + X	Lock (hyprlock)
SUPER + End	Region screenshot → satty → clipboard
SUPER + W / Shift + W	Next / previous wallpaper
SUPER + C	Zen browser at chat.com (workspace 2)
SUPER + Shift + D	Ghostty + nvim in chezmoi source
SUPER + Shift + A	chezmoi apply + reload Hyprland
SUPER + Shift + C	Notes tmux session
SUPER + Shift + M	Supersonic (music)
SUPER + Shift + O	Obsidian (vault)
SUPER + Shift + V	Toggle copyq clipboard history

Focus & movement

Key	Action
SUPER + H/J/K/L or arrows	Focus left / down / up / right
SUPER + Shift + H/J/K/L	Move window
SUPER + Ctrl + H/J/K/L	Resize (20px or column preset)
SUPER + Comma / Period	Focus monitor left / right
SUPER + Tab	Toggle previous workspace
SUPER + 1-0	Switch workspace 1-10
SUPER + Shift + 1-0	Move window to workspace
SUPER + S / Shift + S	Toggle / move-to scratchpad
SUPER + Wheel	Cycle workspaces
SUPER + LMB / RMB	Drag / resize with mouse

Workspaces (auto-routed by class)

WS	Name	Monitor	Routes
1	󰆍 terminal	DP-1	Ghostty, Alacritty, Kitty
2	󰖟 browser	DP-2	Zen, Helium, Firefox, Chrome
3	󰨞 code	DP-1	VSCode, Cursor
4	󰭹 chat	DP-2	Discord, Slack, Signal, Spotify
5	󰊗 games	DP-1	Steam, Lutris, Heroic, wine
6	󰒍 vault	DP-2	Bitwarden, Obsidian, GIMP, Inkscape
7	󰋋 media	DP-2	Supersonic, Stremio
8-10	󰀻 misc	—	transmission-qt, scratch

Media

Key	Action
XF86AudioPlay / Prev / Next	playerctl
XF86AudioRaise/LowerVolume	pactl ±5%
XF86AudioMicMute	mic mute toggle
XF86MonBrightnessUp/Down	brightnessctl ±5%

Apps & system map

• Browser — Zen Browser (Helium also installed)
• File explorer — Yazi (TUI), Dolphin (GUI)
• Clipboard — wl-clipboard, copyq (history)
• Audio — PipeWire stack (pipewire-pulse, wireplumber, pavucontrol)
• Bluetooth — overskride
• Networking — nm-connection-editor (tray via Noctalia)
• Notifications — swaync
• Color picker — hyprpicker (planned)
• Music — Supersonic (Navidrome client, rose-pine themed)
• Video / streaming — mpv (with yt-dlp), Stremio
• Notes — Obsidian (vault) + ~/Documents/Notes (nvim via SUPER + Shift + C)
• Messaging — Signal, Discord
• Local LLMs — ollama-cuda, lmstudio-bin
• Coding agents — Claude Code, opencode
• Gaming — Steam + ProtonPlus, Lutris, Heroic, SteamTinkerLaunch
• Documents — zathura (PDF), glow (markdown)
• Backups — TODO: restic

Per-OS notes

Arch / CachyOS

• All packages declared in .chezmoidata/packages.yaml and installed via paru by run_onchange_install-packages.sh.tmpl.
• Autostart entries (vicinae, noctalia, hypridle, copyq, gammastep, udiskie, …) live in dot_config/hypr/autostart.lua.
• Quick OS bootstrap: boot the Arch ISO → archinstall → log in → run the one-liner above. NVIDIA drivers, kernel mode-setting, multilib: see the Arch wiki — NVIDIA.

macOS

• AeroSpace replaces Yabai/skhd (no SIP changes required): brew install --cask nikitabobko/tap/aerospace.
• SketchyBar + JankyBorders for the bar / focus ring: brew install sketchybar borders.
• After applying: aerospace reload-config && brew services restart sketchybar.
• Best-spotlight: Raycast.

Windows

• Run inside WSL Arch for shell parity.
• Native side: GlazeWM (config at dot_config/glaze_config.yaml), Wox launcher, optional ExplorerPatcher to hide the taskbar.
• wsl --set-default Arch, then run the one-liner from inside WSL.

AI tooling

• Claude Code is the main coding agent. Install: npm install -g @anthropic-ai/claude-code. Optional claude-diff hook for visual diffs of proposed edits.
• Ollama (CUDA) + LM Studio for local model hosting.
• Neovim integrations: claude-code.nvim, minuet-ai, codediff / vscode-diff for AI-edit previews. Config in dot_config/nvim/lua/plugins/.

Local LLM Stack (llama-server + OpenWebUI + opencode)

The local LLM setup uses llama-server (llama.cpp) as the inference server, OpenWebUI as the web interface, and opencode as the CLI agent.

Components

Component	Config Location	Description
llama-server	.config/systemd/user/llama-cpp.service	Systemd user service running Qwen3.6-35B model on port 18081
OpenWebUI	scripts/executable_deploy_openwebui.sh	Docker deployment with --network host
opencode	dot_config/opencode/opencode.jsonc.tmpl	CLI agent config (public parts)

Setup

1. Build llama.cpp (once):

   ./scripts/install_llama_cpp.sh

2. Download model:

   ./scripts/download_models.sh

3. Deploy OpenWebUI:

   ./scripts/deploy_openwebui.sh

4. Start services:

   systemctl --user enable --now llama-cpp

5. Access:

   • OpenWebUI: http://localhost:8080
   • llama-server API: http://localhost:18081/v1

Current Model

• Qwen3.6-35B-IQ4_XS.gguf (18 GB)
• Context size: 120,000 tokens
• Downloaded from HuggingFace: mradermacher/Qwen3.6-35B-Instruct-GGUF

Updating the Model

1. Edit scripts/download_models.sh to change the model repo/symlink

2. Re-run the download script:

   ./scripts/download_models.sh

3. Update systemd service (~/.config/systemd/user/llama-cpp.service) if model name changes:

   ExecStart=/home/.../llama-server --model /home/.../llama-models/[model].gguf --ctx-size 120000 ...

4. Reload and restart:

   systemctl --user daemon-reload
   systemctl --user restart llama-cpp

5. Update opencode config template (dot_config/opencode/opencode.jsonc.tmpl) with new model name and context size, then run chezmoi apply

Troubleshooting

• OpenWebUI can't reach llama-server: Ensure --network host is used in docker run, and OPENAI_API_BASE_URL=http://127.0.0.1:18081/v1
• Model not loading: Check journalctl --user -u llama-cpp for errors
• Port conflict: llama-server defaults to port 18081

Repo layout

.chezmoidata/packages.yaml         # all packages, per-OS
.chezmoi.toml.tmpl                 # bootstrap config (prompts for git identity)
.chezmoiignore                     # secrets / state files to never track
dot_config/                        # → ~/.config/
private_dot_ssh/, private_*        # mode-0600 dirs (still in git — see chezmoiignore)
run_onchange_install-packages.sh.tmpl
run_onchange_install-xontribs.sh.tmpl
run_onchange_install-kvantum-rose-pine.sh
run_onchange_post-install-services.sh.tmpl   # enable sshd, docker.socket
run_onchange_remove-legacy.sh                # purge old zsh/p10k/etc.
justfile                           # `just apply / diff / bootstrap / upgrade`
docs/cheatsheets/                  # git, ssh, vscode reference cards

just recipes wrap the common chezmoi flows: just apply, just diff, just bootstrap <repo>, just upgrade (topgrade), just unmanaged (find files chezmoi doesn't track).

Cheatsheets

Outside-the-stack reference material lives in docs/cheatsheets/ — short notes on git, ssh, and a vscode PDF. Use glow docs/cheatsheets/git.md for in-terminal rendering.

❤️ If RayTerm has been helpful

Star the repo — it helps others discover it.