helios/helios-remote
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
helios-remote/crates/client
History
Helios Agent 5124856b72
fix: embed icon in Windows exe via direct resource.o linker arg
2026-03-06 11:39:42 +01:00
..
src fix: display::cmd_done for inform, remove unused imports, align README 2026-03-06 03:17:54 +01:00
build.rs fix: embed icon in Windows exe via direct resource.o linker arg 2026-03-06 11:39:42 +01:00
Cargo.toml fix: filter cloaked windows (DwmGetWindowAttribute DWMWA_CLOAKED) to exclude background UWP apps 2026-03-06 02:41:12 +01:00
README.md refactor: enforce device labels, unify screenshot, remove deprecated commands, session-id-less design 2026-03-06 01:55:28 +01:00

README.md

helios-client

Windows client for helios-remote. Connects to the relay server via WebSocket and executes commands.

Features

  • Full-screen and per-window screenshots
  • Shell command execution (persistent PowerShell session)
  • Window management (list, focus, maximize, minimize)
  • File upload/download
  • Clipboard get/set
  • Program launch (fire-and-forget)
  • User prompts (MessageBox)
  • Single instance enforcement (PID lock file)

Configuration

On first run, the client prompts for:

  • Relay URL (default: wss://remote.agent-helios.me/ws)
  • API Key
  • Device label — must be lowercase, no whitespace, only a-z 0-9 - _

Config is saved to %APPDATA%/helios-remote/config.toml.

Device Labels

The device label is the sole identifier for this machine. It must follow these rules:

  • Lowercase only
  • No whitespace
  • Only characters: a-z, 0-9, -, _

Examples: moritz_pc, work-desktop, gaming-rig

If an existing config has an invalid label, it will be automatically migrated on next startup.

Build

cargo build -p helios-client --release