docs(windows): add WSL desktop shortcut guide

This commit is contained in:
LeonSGP43 2026-05-10 18:15:34 +08:00 committed by Teknium
parent fe7e0a8c1d
commit 62e81b2d9b

View file

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