\r \r

Opsera\r

\r Opsera is self-contained in this skill directory.\r \r Executable:\r \r

$opsera = Join-Path $env:CODEX_HOME "skills\opsera\bin\opsera.exe"\r
```\r
\r
If `CODEX_HOME` is not set, resolve this skill directory first, then use `bin\opsera.exe` under it.\r
\r
## Modes\r
\r
- No args opens the GUI.\r
- `command` and `file` args run CLI mode for agents.\r
- CLI mode writes events to `%LOCALAPPDATA%\Opsera\events`; GUI shows those command/upload/download events.\r
\r
## Command\r
\r
```powershell\r
& $opsera command run --xsh "\x3Cpath.xsh>" "hostname && whoami"\r
```\r
\r
## Upload\r
\r
```powershell\r
& $opsera file upload --xsh "\x3Cpath.xsh>" "D:\local\file.txt" "/root/file.txt"\r
```\r
\r
## Large Upload\r
\r
Use this for large files. It uploads resumable chunks, keeps SSH alive, merges remotely, and verifies sha256.\r
\r
```powershell\r
& $opsera file upload-large --xsh "\x3Cpath.xsh>" --chunk-mb 512 "D:\local\big.dat" "/root/big.dat"\r
```\r
\r
## Download\r
\r
```powershell\r
& $opsera file download --xsh "\x3Cpath.xsh>" "/root/file.txt" "D:\local\file.txt"\r
```\r
\r
## Rules\r
\r
- Use the bundled `bin\opsera.exe`; do not depend on external install directories.\r
- Use CLI mode, not HTTP, for agent operations.\r
- Do not call Xshell directly.\r
- Use `.xsh` fields `Host`, `Port`, `UserName`, and encrypted session password as parsed by Opsera.\r
- If the `.xsh` tunnel port is closed, ask the user to launch the VPN entry again and rerun immediately.\r
- Do not expose passwords.\r