yoi-server

name	yoi-server
description	Install yoi-server and the dashboard probe, and keep the probe up with systemd. Use when the human wants the server CLI, yoi-dashboard, or a unit that restarts on boot or crash.

yoi-server

Store writes stay on the builtin skill: yoi-server skills get (or yoi-server skills get yoi-server-store). This file is install + probe only.

Ask the human before installing anything. Do not install silently.

Install yoi-server

Fetch and interpret the cmdspec (not a shell script — never curl | sh, no runner binary):

https://raw.githubusercontent.com/AkaraChen/yoi/main/install-yoi-server.cmdspec

Read it, translate RUN / ASSERT / IF into real Unix commands, and execute those. Language: https://github.com/AkaraChen/cmdspec-spec

Windows (PowerShell; cmdspec here is Unix-only):

irm https://raw.githubusercontent.com/AkaraChen/yoi/main/install-yoi-server.ps1 | iex

Default destinations: ${YOI_INSTALL_DIR:-$HOME/.local/bin} or %LOCALAPPDATA%\yoi\bin (add that directory to PATH). Overwrite is upgrade. A 404 means no v* Release exists yet — stop; do not leave a half-install.

Install yoi-dashboard (Linux)

Same Release as the CLIs. Prefer the cmdspec (interpret, do not sh):

https://raw.githubusercontent.com/AkaraChen/yoi/main/install-yoi-dashboard.cmdspec

Or download https://github.com/AkaraChen/yoi/releases/latest/download/yoi-dashboard_linux_<amd64|arm64>.tar.gz plus checksums.txt, verify sha256, and put yoi-dashboard on PATH (same dest as above).

Windows and macOS for the probe are not covered — improvise if asked.

systemd (Linux)

Prefer a user or system unit so the probe restarts on boot and crash. Bind 127.0.0.1:8788. Password comes from YOI_DASHBOARD_PASSWORD — do not ship the development default yoi in a real unit. Store is ~/.yoi or YOI_DASHBOARD_STORE / -store.

User unit example (~/.config/systemd/user/yoi-dashboard.service):

[Unit]
Description=yoi dashboard probe
After=network.target

[Service]
ExecStart=%h/.local/bin/yoi-dashboard -addr 127.0.0.1:8788 -store %h/.yoi
Environment=YOI_DASHBOARD_PASSWORD=replace-me
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target

Then: systemctl --user daemon-reload && systemctl --user enable --now yoi-dashboard.service. For start-at-boot without a login session: loginctl enable-linger "$USER".

System unit example (/etc/systemd/system/yoi-dashboard.service) if the human wants a machine-wide service — change User, ExecStart, and YOI_DASHBOARD_STORE to that account's paths:

[Unit]
Description=yoi dashboard probe
After=network.target

[Service]
User=replace-me
ExecStart=/usr/local/bin/yoi-dashboard -addr 127.0.0.1:8788
Environment=YOI_DASHBOARD_PASSWORD=replace-me
Environment=YOI_DASHBOARD_STORE=/home/replace-me/.yoi
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target