jb/paseo
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

docs(hub): clarify daemon slug references (#2952)

Browse Source 
Hub configuration resolves a normalized friendly slug to an immutable daemon ID. Document that model consistently so enrollment terminology matches hub.yml.
This commit is contained in:
Mohamed Boudra
2026-08-06 22:00:06 +02:00
committed by GitHub
parent 42bfd4e04c
commit 1e03e2d120
4 changed files with 9 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
public-docs/hub/daemons.md
+5 -3
View File
@@ -18,9 +18,11 @@ On the machine:
paseo hub connect https://hub.example.com
```
The CLI prints a URL and a verification code, and opens your browser if it can. In Hub, open **Daemons → Register a daemon**, enter the code, name the daemon, and approve it.
The CLI prints a URL and a verification code, and opens your browser if it can. In Hub, open **Daemons → Register a daemon**, enter the code, choose a friendly slug, and approve it.
The name you choose here is what configuration references. It can be renamed later, but renaming after a configuration is active means updating that configuration.
Each daemon has two identifiers: an immutable generated ID and a friendly slug. Hub normalizes the slug you enter with lowercase words joined by hyphens, so `Build Studio` becomes `build-studio`. The slug is what the dashboard shows and what configuration references.
You can rename the slug later without changing the daemon ID. Renaming after a configuration is active means updating that configuration.
For unattended setup, skip the browser with an enrollment token:
@@ -48,7 +50,7 @@ environments:
cwd: /Users/you/code/your-repo
```
`daemon` is the display name. It resolves to a daemon id when the configuration activates, so a daemon that no longer exists fails activation instead of failing at dispatch.
`daemon` is the friendly slug. It resolves to the immutable daemon ID when the configuration activates, so a daemon that no longer exists fails activation instead of failing at dispatch.
`cwd` is a path on that machine. Hub does not clone anything for you; the directory must already exist.