netopsengineer

Wsl Fedora Guest Tools — AI skill for Claude Code

AI community

A robust bootstrapper and idempotent update utility for Fedora WSL environments and AI tool chains.

How to install Wsl Fedora Guest Tools

This entry records only its repository, not the path inside it, so there is no exact command to give. Open netopsengineer/wsl-fedora-guest-tools and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Wsl Fedora Guest Tools does

A robust bootstrapper and idempotent update utility for Fedora WSL environments and AI tool chains.

Alternatives in AI

Model Update — 增量更新财务模型 — 用新财报/新指引/修正假设重算 DCF 内在价值、Comps 隐含价、投资逻辑与目标价，输出 before→after delta 6.6k ★
Update Branch Name — by giselles-ai - Updates branch names with proper prefixes and formats, enforcing naming conventions, supporti 502 ★
Skilldock — SkillDock is an AI skill manager and skill management desktop app for Claude Code, Cursor, Codex, Windsurf, Ge 490 ★

README

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