Appearance
Host lanes
The repo supports three lanes with different responsibilities.
WSL
WSL is the default lane for active repos, Codex work, Linux shell workflows, and development state. Keep active project paths under the Linux filesystem, for example /home/alvaro/code/project.
Ubuntu WSL uses apt with repo-owned upstream sources where the base distro lags the workstation policy. Fish comes from the official Fish 4 PPA so shell validation matches the managed Fish 4 configuration.
CachyOS
CachyOS is the native Linux desktop lane. It shares the Unix-like shell and tool policy with WSL, but desktop integrations should stay explicit and small.
Native Windows
Native Windows owns PowerShell, Scoop and winget bootstrap, GUI app setup, and Windows-specific path behavior. PowerShell is a peer shell, not a Bash clone.
Cross-lane policy
Chezmoi templates should express host differences directly. Avoid duplicate full files when a narrow template or host gate will keep the policy clear.