Skip to content

risu729/dotfiles

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3,410 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🐿 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:

πŸ› οΈ 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

About

🐿️ Risu's dotfiles bonsai 🌳 for Windows 11 πŸͺŸ and WSL 2 🐧

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors