cross-platform-guardian

Protect macOS, Ubuntu, Fedora, and Linux/WSL compatibility in this dotfiles repository. Use for portability reviews, Nix changes, bootstrap changes, and platform test failures.

Jump to install

Repository: wcygan/dotfiles
Last source activity: August 9, 2026 at 18:34
Detected SKILL.md language: English
Stars: 194
Forks: 16

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/wcygan/dotfiles --skill cross-platform-guardian

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

5 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

Cross-Platform Guardian

Outcome

Keep the setup path reproducible across macOS, Ubuntu, Fedora, and Linux/WSL without hard-coded machine paths or untested platform assumptions.

Current Setup Boundary

bootstrap.sh is the supported entry point. It loads Nix, enters nix develop .#default, and runs uv run --locked python -m dotfiles_setup.

macOS delegates missing-Nix installation to the Determinate package handoff.

Linux and WSL require ./bootstrap.sh --install-nix --yes before the bootstrapper runs the official Determinate installer.

Python modules under src/dotfiles_setup/ own profile, link, cleanup, diagnostics, Rust, Git identity, and opt-in shell handoff behavior.

The default install must not edit Bash or zsh startup files; shell-handoff is explicit.

Review Workflow

Inspect bootstrap.sh, the affected Python module, flake.nix, and the matching pytest coverage before proposing a change.

Check macOS and Linux/WSL behavior separately. Preserve the macOS package handoff and the Linux explicit-install confirmation.

Keep platform paths behind the functions in links.py; use HOME, XDG_CONFIG_HOME, and CODEX_HOME rather than user-specific paths.

Run make test-pre, then the focused suite: make test-local for links, make test-shell for handoff, and make test-docker for Ubuntu/Fedora acceptance when the blast radius is cross-platform.

Report platform evidence, skipped checks, and the rollback path. Nix package regressions roll back with nix profile rollback; managed links preserve timestamped backups.

Stop Conditions

Do not claim macOS packaged behavior from a Linux container. Do not add a second installer, restore retired shell setup scripts, or mutate user startup files without the explicit shell-handoff request.

name	cross-platform-guardian
description	Protect macOS, Ubuntu, Fedora, and Linux/WSL compatibility in this dotfiles repository. Use for portability reviews, Nix changes, bootstrap changes, and platform test failures.