diff --git a/website/docs/user-guide/windows-wsl-quickstart.md b/website/docs/user-guide/windows-wsl-quickstart.md index baf11f468db..937c643a4dc 100644 --- a/website/docs/user-guide/windows-wsl-quickstart.md +++ b/website/docs/user-guide/windows-wsl-quickstart.md @@ -260,6 +260,32 @@ For webhooks from cloud messaging providers (Telegram `setWebhook`, Slack events The Hermes [Tool Gateway](/user-guide/features/tool-gateway) and the API server are long-lived processes. In WSL2 you have a few options for keeping them up. +### Desktop shortcut for opening Hermes quickly + +If you just want a double-click launcher for an interactive Hermes shell, create +it on the Windows side and have it jump into WSL for you: + +1. Right-click the Windows desktop and choose **New -> Shortcut**. +2. For the target, use your distro name (replace `Ubuntu` if needed): + + ```text + wt.exe -w 0 -p "Ubuntu" wsl.exe -d Ubuntu --cd ~ -- bash -ic "hermes" + ``` + +3. Name it something obvious like `Hermes`. + +That opens Windows Terminal, starts your WSL distro, drops you in your Linux +home directory, and launches Hermes. If `hermes` is not on PATH yet, open WSL +once manually and run `source ~/.bashrc`, or replace the command with +`uv run hermes` inside your project checkout. + +Optional polish: + +- **Custom icon:** open **Properties -> Change Icon** and point it at an `.ico` + file, such as the Hermes favicon from the repo. +- **Pinned launcher:** once the shortcut works, pin it to Start or Taskbar so + you do not have to browse for it again. + ### Inside WSL with systemd (recommended) If you enabled systemd per the setup section above, `hermes gateway` and the API server work the way they do on any Linux machine. Use the gateway setup wizard: