Wsl Fedora Guest Tools

WSL Fedora Guest Tools

A robust bootstrapper and idempotent update utility for Fedora WSL environments. It orchestrates critical system installs and updates via DNF5 alongside optional updates for developer tools and AI CLIs: Volta/Node.js, `uv` (self-update and tool upgrades), GitHub CLI, Claude Code, and Codex.

Why

Developer tooling and AI CLIs change frequently. Keeping everything current often resolves issues quickly and unlocks new features. On macOS, `brew update && brew upgrade` makes this easy. This project provides a similarly reliable workflow for Fedora on WSL.

Features

• System Updates: Safe DNF5-based system package upgrades
• Baseline Bootstrap: Idempotent install of required Fedora packages
• Global Opt-In: All optional tools default to OFF; enable via profile, config, or CLI flags
• Code-First Tool Logic: Tool update behavior stays in code for clear review and predictable behavior
• Profiles + Selectors: Use --profile, --only, and --skip to avoid skip-flag sprawl as tools grow
• Persistent Defaults: Optional user config for default profile and ENABLED_TOOLS allowlist or DISABLED_TOOLS denylist
• DNF Always-On: dnf runs on every invocation unless explicitly --skip dnf
• Idempotent: Safe to run repeatedly; no-op when already current
• Comprehensive Error Handling: Detailed exit codes, lockfile-based concurrency control, and remediation hints
• Dry-Run Mode: Preview commands before execution
• Strict Mode: Fail immediately on any optional step failure (CI-friendly)
• Detailed Logging: Timestamped logs with step-by-step progress tracking

AI-First Design

This project is designed to be modified safely by AI agents. [`AGENTS.md`](AGENTS.md) gives an agent everything it needs to make correct changes without human supervision:

• Invariants — hard constraints that must never be violated (gate sequence, wrapper requirement, strict bash mode, etc.)
• Checklists — step-by-ste