🐿 Risu's Dotfiles

⭐ Description

These dotfiles are used to configure my environment, mainly Windows 11 and WSL2 (Ubuntu).

Since I use WSL2 as my main development environment, I only install GUI applications on Windows, such as browsers, IDEs, etc.

🧭 Repository Structure

This repository is organized around the two installer entry points: win/install.ps1 for Windows and wsl/install.sh for WSL2.

• win/ contains the Windows setup script, winget package list, PowerToys settings backup, and Windows application configuration files.

• wsl/ contains the WSL setup script and the files it installs into the WSL environment.

  • wsl/home/ mirrors the target home directory. The installer links these files into $HOME, except for Codex skills, which are copied because Codex does not discover symlinked skill files.
  • wsl/etc/ mirrors root-owned system files. The installer links these files into /etc.
  • wsl/setup-git.ts performs interactive Git account setup after the base WSL environment is ready.

• worker/ is a Cloudflare Worker for dot.risunosu.com. It redirects the root route to this README and serves the /win and /wsl installer routes by fetching the matching scripts from GitHub and injecting repository/ref metadata.

• docker/ and compose.ci.yml define the Ubuntu WSL-like test environment used by CI to exercise the WSL installer.

• .github/workflows/ contains linting, installer test, worker, autofix, and PR maintenance workflows.

• github/ contains GitHub repository configuration files managed outside .github/, such as rulesets.json.

• The root configuration files (mise.toml, tasks.toml, hk.pkl, and the formatter/linter configs) define the development toolchain and checks for both the root repository and the worker package.

⚙️ Installation

🪟 Windows 11

Important

Set up Windows 11 without a Microsoft account to avoid the automatic installation of OneDrive.

1. Press Shift + F10 on the startup screen (do not connect to the internet).

2. Run the following command in Command Prompt:

   start ms-cxh:localonly

3. Continue the setup without a Microsoft account by selecting I don't have internet.

1. Update Windows 11 to the latest version.
2. Uninstall OneDrive.
3. In Windows Terminal (PowerShell, Windows PowerShell, or Command Prompt), run the following command.

powershell -c "irm dot.risunosu.com/win | iex"

🐧 WSL2

The Windows installer script will install dotfiles in WSL2, so you don't need to run the installer script again.

However, if you want to install dotfiles to WSL2 only—such as when you reset WSL2—you can run the following command in bash:

bash -i <(curl -fsSL https://dot.risunosu.com/wsl)

Important

Use process substitution (<()) instead of piping (|) for interactive scripts.

Tip

Both installer scripts are idempotent, meaning you can run them multiple times without issues.

➡️ What to Do Next

1. Uninstall unnecessary software pre-installed by Windows 11.

2. Restore PowerToys settings. See docs.

3. Install the following software on Windows, which the script does not install:

• Lenovo Vantage (Cannot be installed via winget.)

• Minecraft Launcher (Cannot be installed via winget.)

• LINE (Cannot be installed via winget.)

🛠️ Development

⚙️ Setup

Prerequisites: mise

Clone this repository and run the following command:

mise i
mise deps

🧵 Lint and Format

The following command will lint and format the code, including auto-fixes:

mise check

📜 License

MIT