mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-06-20 10:11:58 +00:00
docs(windows): add WSL desktop shortcut guide
This commit is contained in:
parent
fe7e0a8c1d
commit
62e81b2d9b
1 changed files with 26 additions and 0 deletions
|
|
@ -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:
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue