Skip to content

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.