Opsera

Use the bundled Opsera executable as the Xshell replacement for VPN-launched sessions. Use when an agent needs to run commands or upload/download files through a current VPN-created .xsh local SSH tunnel. The bundled exe works as both GUI and CLI.

Opsera is self-contained in this skill directory.

Executable:

$opsera = Join-Path $env:CODEX_HOME "skills\opsera\bin\opsera.exe"

If CODEX_HOME is not set, resolve this skill directory first, then use bin\opsera.exe under it.

Modes

• No args opens the GUI.
• command and file args run CLI mode for agents.
• CLI mode writes events to %LOCALAPPDATA%\Opsera\events; GUI shows those command/upload/download events.

Command

& $opsera command run --xsh "<path.xsh>" "hostname && whoami"

Upload

& $opsera file upload --xsh "<path.xsh>" "D:\local\file.txt" "/root/file.txt"

Large Upload

Use this for large files. It uploads resumable chunks, keeps SSH alive, merges remotely, and verifies sha256.

& $opsera file upload-large --xsh "<path.xsh>" --chunk-mb 512 "D:\local\big.dat" "/root/big.dat"

Download

& $opsera file download --xsh "<path.xsh>" "/root/file.txt" "D:\local\file.txt"

Rules

• Use the bundled bin\opsera.exe; do not depend on external install directories.
• Use CLI mode, not HTTP, for agent operations.
• Do not call Xshell directly.
• Use .xsh fields Host, Port, UserName, and encrypted session password as parsed by Opsera.
• If the .xsh tunnel port is closed, ask the user to launch the VPN entry again and rerun immediately.
• Do not expose passwords.