My Arch Linux + Hyprland workstation and agentic development environment, as code. Dual-4K, Wayland-native, keyboard-and-mouse driven, tuned through daily use — not a screenshot rice and not a generic starter kit.
Every binding here earns its place. The interesting parts aren't the colors; they're the small behavioral fixes that a tiling WM doesn't give you for free.
hypr/ Hyprland + hyprlock + helper scripts
tmux/ tmux: vi-mode, clipboard, fzf session picker, voice input
git/ audible feedback on every commit
operator/ portable launchers for isolated worktrees and concurrent agent seats
enforcement/ AST rules and architecture gates extracted from production work
shell/ current-directory shortcuts for separately authenticated CLI profiles
install.sh symlink everything into place (idempotent, backs up originals)
bootstrap/ dependency manifest + read-only workstation doctor
Monitor-aware workspaces. On a dual-head setup, vanilla Hyprland workspace
keys are global — SUPER+3 yanks you to whichever monitor owns workspace 3.
hypr/scripts/switch-workspace-current-monitor.sh remaps 1-10 to the
monitor your focus is on, so the number keys mean the same thing on either
screen. Same idea for moving windows. Each monitor owns a disjoint workspace
range (1-5 left, 6-10 right) and the scripts do the translation.
Scratchpad with memory. hypr/scripts/scratchpad.sh stashes a window to a
special workspace and remembers where it came from, so un-stashing returns it
to its origin workspace — not wherever you happen to be standing. State is a
flat address workspace file in /tmp; no daemon.
Focus-or-launch toggle. SUPER+C focuses VS Code if it's running, launches
it if not, and — pressed again while already focused — bounces back to the
window you came from. One key, three behaviors, via a tiny state file.
Golden-ratio pointer. sensitivity = -0.6180 (φ − 1, negated). Petty?
Maybe. It feels right and I can defend every magic number in here.
Screenshots that always hit the clipboard. Area/full/window all wl-copy;
full and window also archive to ~/Pictures/Screenshots. grim + slurp,
no GUI tool in the path.
tmux that gets out of the way. Ctrl-A prefix, vi-style panes and copy,
splits inherit the current path, whole-pane capture straight to the Wayland
clipboard (M-a), an fzf session picker in a popup (prefix f), and a
push-to-talk whisper binding that types a transcription into the focused pane.
Catppuccin status bar, resurrect + continuum so a reboot restores the session.
Sound on commit. A post-commit hook that gives audible feedback the
moment a commit lands — a standalone zero-dependency variant (plays a cue via
whatever audio player exists) and the event-driven one I actually run (POSTs
the commit to a local API that fans it out to every open surface). See
git/README.md.
One gesture, one isolated lane. Mouse side buttons can open separately
authenticated Claude Code seats in fresh tmux sessions. The worktree launcher
goes further: it creates a branch from an explicit base, places the worktree on
a dedicated worktree volume (with a configurable fallback), and starts the
chosen CLI profile inside it. See operator/.
Several tools, explicit identities. Claude Code, Codex and Antigravity can run at the same time without pretending they share one account or one state directory. The public scripts describe profile selection and process isolation; credentials and provider session data never enter this repository.
Architecture that fails before review. The enforcement/
toolkit turns decisions such as “time is injected,” “the ORM stays in adapters,”
and “browser storage is not session authority” into ast-grep rules. It is a
small public extraction of the larger custom ESLint, dependency-boundary and
debt-ratchet system I use in production-sized monorepos.
git clone https://github.com/ghostON3/ghost-dotfiles.git
cd ghost-dotfiles
./bootstrap.sh --dry-run
./bootstrap.sh --apply --profiles desktop,developer,operator,voicebootstrap.sh installs selected official Arch packages and delegates to the
ownership-safe linker. Dry-run is the default. Credentials are restored through
the separate private boundary described in the
fresh-machine runbook.
After installation, inspect the machine without changing it:
./bootstrap/doctor.sh
./bootstrap/doctor.sh --strict # non-zero when a core capability is missing
./tests/bootstrap-smoke.sh # isolated HOME; does not touch live configCore: hyprland hyprlock kitty rofi swww wl-clipboard cliphist grim slurp wlsunset jq.
Optional (for specific binds): wlogout playerctl wireplumber ddcutil dolphin google-chrome.
tmux: tmux + tpm (prefix + I to
fetch plugins) + wl-clipboard.
Provider credentials, subscription state, machine inventory and usage history
stay private. The reusable mechanics — agent-seat launchers, worktree isolation,
mouse bindings and shell functions — are public. hypr/hyprland.conf sources an
optional personal.conf that is gitignored; hypr/personal.conf.example wires
the portable commands without embedding account data.
2× 3840×2160 @ 60 (DP-1 / DP-2), US/SK keyboard layouts, external-monitor
brightness over DDC/CI. Monitor names and --bus numbers are mine — change
them to yours.
MIT. Take what's useful.