From 9c429ce20e49af8e6ef642e63248539c86a2e1d0 Mon Sep 17 00:00:00 2001
From: Helios Agent <agent.helios82@gmail.com>
Date: Fri, 6 Mar 2026 15:24:14 +0100
Subject: [PATCH] docs: update README and SKILL.md - document update system,
 rename binaries

---
 README.md | 17 ++++++++++++++---
 SKILL.md  | 14 +++++++++-----
 2 files changed, 23 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 05eb434..c0f4c22 100644
--- a/README.md
+++ b/README.md
@@ -31,8 +31,8 @@ irm https://raw.githubusercontent.com/agent-helios/helios-remote/master/scripts/
 ```
 AI Agent
    │
-   ▼  remote CLI
-helios-server ──WebSocket── helios-client (Windows)
+   ▼  helios-remote-cli
+helios-remote-relay ──WebSocket── helios-remote-client (Windows)
 ```
 
 1. The **Windows client** connects to the relay server via WebSocket and registers with its device label.
@@ -62,11 +62,22 @@ remote clipboard-get <device>                     # get clipboard text
 remote clipboard-set <device> <text>              # set clipboard text
 remote upload <device> <local> <remote>           # upload file to device
 remote download <device> <remote> <local>         # download file from device
-remote version <device>                           # compare relay/helios/client commits
+remote version <device>                           # compare latest/relay/cli/client commits
+remote update <device>                            # update all components to latest version
 remote logs <device>                              # fetch last 20 lines of client log (default)
 remote logs <device> --lines 200                  # custom line count
 ```
 
+### Update System
+
+`remote update <device>` checks `version.json` on the download server for the latest available commit and updates any component that's behind:
+
+- **Relay** — downloads new binary, replaces itself, restarts via systemd
+- **Client** — downloads new binary, replaces itself, relaunches automatically
+- **CLI** — downloads new binary, replaces itself, re-executes the update command
+
+CI publishes new binaries after every push to `master` but does **not** auto-restart the relay. Updates only happen when explicitly triggered via `remote update`.
+
 ---
 
 ## Server Setup
diff --git a/SKILL.md b/SKILL.md
index ddef201..a98d4c3 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -73,12 +73,16 @@ $SKILL_DIR/helios clipboard-set moritz-pc "Text for clipboard"
 $SKILL_DIR/helios upload moritz-pc /tmp/local.txt "C:\Users\Moritz\Desktop\remote.txt"
 $SKILL_DIR/helios download moritz-pc "C:\Users\Moritz\file.txt" /tmp/downloaded.txt
 
-# Version: compare relay + remote + client commits (are they in sync?)
-$SKILL_DIR/helios version moritz-pc
+# Version: compare latest available vs running commits (relay / cli / client)
+$SKILL_DIR/remote version moritz-pc
 
-# Client log (last 100 lines, --lines for more)
-$SKILL_DIR/helios logs moritz-pc
-$SKILL_DIR/helios logs moritz-pc --lines 200
+# Update: bring all components (relay, cli, client) to latest version
+# CI publishes new binaries but does NOT auto-restart — this triggers the actual update
+$SKILL_DIR/remote update moritz-pc
+
+# Client log (last 20 lines by default, --lines for more)
+$SKILL_DIR/remote logs moritz-pc
+$SKILL_DIR/remote logs moritz-pc --lines 200
 ```
 
 ## Typical Workflow: UI Task