Skip to main content

Orbitus Robotics / minimal remote tools

ViperLink.
Just the control you need.

Choose a connection. Install a small component.
Keep RedAgent for the full security test workbench.

ViperLink twin-viper shield
v0.4.0Source pilot

Small, reviewable source packages for your authorized machines. User installs need an existing Node.js or Python runtime. The Windows administrator install includes its own runtime and startup task. Private enrollment stays separate. Compare with RedAgent ↓

1. Choose the control mechanism

These sizes include the selected source files and setup notes; the installer adds a small receipt. Runtime disk use is additional. Install multiple components by running each selected command.

2. Choose this computer’s platform

All platforms shown.

Cloud Fleet commands

Execution target · Node.js 22+

Windows / PowerShell 5.1+

& { $ErrorActionPreference='Stop'; if ($ExecutionContext.SessionState.LanguageMode -ne 'FullLanguage') { throw 'Use your administrator-approved installer: PowerShell language is restricted.' }; if ((Get-ExecutionPolicy -Scope MachinePolicy) -ne 'Undefined' -or (Get-ExecutionPolicy -Scope UserPolicy) -ne 'Undefined' -or (Get-ExecutionPolicy) -eq 'AllSigned') { throw 'Use your administrator-approved installer: a managed or signing policy is configured.' }; $p=Join-Path $env:TEMP ('viperlink-'+[guid]::NewGuid()+'.ps1'); try { Invoke-WebRequest -UseBasicParsing https://www.orbitusrobotics.com/v/install.ps1 -OutFile $p -TimeoutSec 120 -ErrorAction Stop; $b=[IO.File]::ReadAllBytes($p); $h=[Security.Cryptography.SHA256]::Create(); try { $s=[BitConverter]::ToString($h.ComputeHash($b)).Replace('-','').ToLowerInvariant() } finally { $h.Dispose() }; if ($s -ne '8705ffe47b91e234239adbe3782b6317973b2500058c4ce1914ef631712dd252') { throw 'Installer SHA-256 mismatch. Download the latest command or Flipper script from the website.' }; Write-Host ('Verified installer: '+$p); & ([scriptblock]::Create([Text.Encoding]::UTF8.GetString($b))) -Component cloud } finally { if (Test-Path -LiteralPath $p) { Remove-Item -LiteralPath $p -Force } } }
Install Cloud Fleet commands

Run in your signed-in user’s terminal. The installer checks the runtime and each file’s pinned SHA-256, then prints its destination.

Review installer · Windows + cloud user Flipper script ↓
Then provision and start

Follow START.txt in the installed folder. This command installs the component; its private profile and startup remain explicit.

Cloud Fleet commands setup →
Administrator install: all users + startup

Installs the Cloud Fleet receiver and a verified private Node runtime in Program Files. Approve the normal UAC prompt. The visible “Orbitus ViperLink Cloud” task runs as LocalService at boot, before login, and waits for private enrollment. It also starts immediately.

& { $ErrorActionPreference='Stop'; if ($ExecutionContext.SessionState.LanguageMode -ne 'FullLanguage') { throw 'Use your administrator-approved installer: PowerShell language is restricted.' }; if ((Get-ExecutionPolicy -Scope MachinePolicy) -ne 'Undefined' -or (Get-ExecutionPolicy -Scope UserPolicy) -ne 'Undefined' -or (Get-ExecutionPolicy) -eq 'AllSigned') { throw 'Use your administrator-approved installer: a managed or signing policy is configured.' }; $sid=[Security.Principal.WindowsIdentity]::GetCurrent().User.Value; $c='& { $ErrorActionPreference=''Stop''; if ($ExecutionContext.SessionState.LanguageMode -ne ''FullLanguage'') { throw ''Use your administrator-approved installer: PowerShell language is restricted.'' }; if ((Get-ExecutionPolicy -Scope MachinePolicy) -ne ''Undefined'' -or (Get-ExecutionPolicy -Scope UserPolicy) -ne ''Undefined'' -or (Get-ExecutionPolicy) -eq ''AllSigned'') { throw ''Use your administrator-approved installer: a managed or signing policy is configured.'' }; $p=Join-Path $env:TEMP (''viperlink-''+[guid]::NewGuid()+''.ps1''); try { Invoke-WebRequest -UseBasicParsing https://www.orbitusrobotics.com/v/install.ps1 -OutFile $p -TimeoutSec 120 -ErrorAction Stop; $b=[IO.File]::ReadAllBytes($p); $h=[Security.Cryptography.SHA256]::Create(); try { $s=[BitConverter]::ToString($h.ComputeHash($b)).Replace(''-'','''').ToLowerInvariant() } finally { $h.Dispose() }; if ($s -ne ''8705ffe47b91e234239adbe3782b6317973b2500058c4ce1914ef631712dd252'') { throw ''Installer SHA-256 mismatch. Download the latest command or Flipper script from the website.'' }; Write-Host (''Verified installer: ''+$p); & ([scriptblock]::Create([Text.Encoding]::UTF8.GetString($b))) -Component cloud -Scope Machine -ControlUser ORBITUS_CALLER_SID } finally { if (Test-Path -LiteralPath $p) { Remove-Item -LiteralPath $p -Force } } }'; $c=$c.Replace('ORBITUS_CALLER_SID',$sid); $exe=if ($PSVersionTable.PSEdition -eq 'Core') { 'pwsh.exe' } else { 'powershell.exe' }; Start-Process -FilePath (Join-Path $PSHOME $exe) -Verb RunAs -ArgumentList ('-NoLogo -NoProfile -NoExit -Command '+[char]34+$c+[char]34) -ErrorAction Stop }

Windows administrator Flipper script ↓ · Machine enrollment and removal →

macOS / Terminal

d=$(mktemp -d) && curl -fsSL --proto "=https" --proto-redir "=https" https://www.orbitusrobotics.com/v/install.sh -o "$d/install.sh" && sh "$d/install.sh" --component cloud
Install Cloud Fleet commands

Run in your signed-in user’s terminal. The installer checks the runtime and each file’s pinned SHA-256, then prints its destination.

Review installer · macOS + cloud user Flipper script ↓
Then provision and start

Follow START.txt in the installed folder. This command installs the component; its private profile and startup remain explicit.

Cloud Fleet commands setup →

Linux / Terminal

d=$(mktemp -d) && curl -fsSL --proto "=https" --proto-redir "=https" https://www.orbitusrobotics.com/v/install.sh -o "$d/install.sh" && sh "$d/install.sh" --component cloud
Install Cloud Fleet commands

Run in your signed-in user’s terminal. The installer checks the runtime and each file’s pinned SHA-256, then prints its destination.

Review installer · Linux + cloud user Flipper script ↓
Then provision and start

Follow START.txt in the installed folder. This command installs the component; its private profile and startup remain explicit.

Cloud Fleet commands setup →

Read setup notes · Download source ZIP (19.1 KiB)

Status reporting only

Reporting client · Node.js 22+

Windows / PowerShell 5.1+

& { $ErrorActionPreference='Stop'; if ($ExecutionContext.SessionState.LanguageMode -ne 'FullLanguage') { throw 'Use your administrator-approved installer: PowerShell language is restricted.' }; if ((Get-ExecutionPolicy -Scope MachinePolicy) -ne 'Undefined' -or (Get-ExecutionPolicy -Scope UserPolicy) -ne 'Undefined' -or (Get-ExecutionPolicy) -eq 'AllSigned') { throw 'Use your administrator-approved installer: a managed or signing policy is configured.' }; $p=Join-Path $env:TEMP ('viperlink-'+[guid]::NewGuid()+'.ps1'); try { Invoke-WebRequest -UseBasicParsing https://www.orbitusrobotics.com/v/install.ps1 -OutFile $p -TimeoutSec 120 -ErrorAction Stop; $b=[IO.File]::ReadAllBytes($p); $h=[Security.Cryptography.SHA256]::Create(); try { $s=[BitConverter]::ToString($h.ComputeHash($b)).Replace('-','').ToLowerInvariant() } finally { $h.Dispose() }; if ($s -ne '8705ffe47b91e234239adbe3782b6317973b2500058c4ce1914ef631712dd252') { throw 'Installer SHA-256 mismatch. Download the latest command or Flipper script from the website.' }; Write-Host ('Verified installer: '+$p); & ([scriptblock]::Create([Text.Encoding]::UTF8.GetString($b))) -Component status } finally { if (Test-Path -LiteralPath $p) { Remove-Item -LiteralPath $p -Force } } }
Install Status reporting only

Run in your signed-in user’s terminal. The installer checks the runtime and each file’s pinned SHA-256, then prints its destination.

Review installer · Windows + status user Flipper script ↓
Then provision and start

Follow START.txt in the installed folder. This command installs the component; its private profile and startup remain explicit.

Status reporting only setup →

macOS / Terminal

d=$(mktemp -d) && curl -fsSL --proto "=https" --proto-redir "=https" https://www.orbitusrobotics.com/v/install.sh -o "$d/install.sh" && sh "$d/install.sh" --component status
Install Status reporting only

Run in your signed-in user’s terminal. The installer checks the runtime and each file’s pinned SHA-256, then prints its destination.

Review installer · macOS + status user Flipper script ↓
Then provision and start

Follow START.txt in the installed folder. This command installs the component; its private profile and startup remain explicit.

Status reporting only setup →

Linux / Terminal

d=$(mktemp -d) && curl -fsSL --proto "=https" --proto-redir "=https" https://www.orbitusrobotics.com/v/install.sh -o "$d/install.sh" && sh "$d/install.sh" --component status
Install Status reporting only

Run in your signed-in user’s terminal. The installer checks the runtime and each file’s pinned SHA-256, then prints its destination.

Review installer · Linux + status user Flipper script ↓
Then provision and start

Follow START.txt in the installed folder. This command installs the component; its private profile and startup remain explicit.

Status reporting only setup →

Read setup notes · Download source ZIP (9.8 KiB)

LAN / VPN controller

Controller only · Python 3.10+ / OpenSSL TLS 1.3

Windows / PowerShell 5.1+

& { $ErrorActionPreference='Stop'; if ($ExecutionContext.SessionState.LanguageMode -ne 'FullLanguage') { throw 'Use your administrator-approved installer: PowerShell language is restricted.' }; if ((Get-ExecutionPolicy -Scope MachinePolicy) -ne 'Undefined' -or (Get-ExecutionPolicy -Scope UserPolicy) -ne 'Undefined' -or (Get-ExecutionPolicy) -eq 'AllSigned') { throw 'Use your administrator-approved installer: a managed or signing policy is configured.' }; $p=Join-Path $env:TEMP ('viperlink-'+[guid]::NewGuid()+'.ps1'); try { Invoke-WebRequest -UseBasicParsing https://www.orbitusrobotics.com/v/install.ps1 -OutFile $p -TimeoutSec 120 -ErrorAction Stop; $b=[IO.File]::ReadAllBytes($p); $h=[Security.Cryptography.SHA256]::Create(); try { $s=[BitConverter]::ToString($h.ComputeHash($b)).Replace('-','').ToLowerInvariant() } finally { $h.Dispose() }; if ($s -ne '8705ffe47b91e234239adbe3782b6317973b2500058c4ce1914ef631712dd252') { throw 'Installer SHA-256 mismatch. Download the latest command or Flipper script from the website.' }; Write-Host ('Verified installer: '+$p); & ([scriptblock]::Create([Text.Encoding]::UTF8.GetString($b))) -Component lan } finally { if (Test-Path -LiteralPath $p) { Remove-Item -LiteralPath $p -Force } } }
Install LAN / VPN controller

Run in your signed-in user’s terminal. The installer checks the runtime and each file’s pinned SHA-256, then prints its destination.

Review installer · Windows + lan user Flipper script ↓
Then provision and start

Follow START.txt in the installed folder. This command installs the component; its private profile and startup remain explicit.

LAN / VPN controller setup →

macOS / Terminal

d=$(mktemp -d) && curl -fsSL --proto "=https" --proto-redir "=https" https://www.orbitusrobotics.com/v/install.sh -o "$d/install.sh" && sh "$d/install.sh" --component lan
Install LAN / VPN controller

Run in your signed-in user’s terminal. The installer checks the runtime and each file’s pinned SHA-256, then prints its destination.

Review installer · macOS + lan user Flipper script ↓
Then provision and start

Follow START.txt in the installed folder. This command installs the component; its private profile and startup remain explicit.

LAN / VPN controller setup →

Linux / Terminal

d=$(mktemp -d) && curl -fsSL --proto "=https" --proto-redir "=https" https://www.orbitusrobotics.com/v/install.sh -o "$d/install.sh" && sh "$d/install.sh" --component lan
Install LAN / VPN controller

Run in your signed-in user’s terminal. The installer checks the runtime and each file’s pinned SHA-256, then prints its destination.

Review installer · Linux + lan user Flipper script ↓
Then provision and start

Follow START.txt in the installed folder. This command installs the component; its private profile and startup remain explicit.

LAN / VPN controller setup →

Read setup notes · Download source ZIP (4.5 KiB)

User or machine installation. User scripts install only the selected component and require a separately installed runtime. The Windows Cloud administrator script includes a private Node runtime and a machine startup task. No npm or pip packages are installed.

Windows “running scripts is disabled”? Replace older Flipper scripts with the current download. The updated console command checks the installer SHA-256 and leaves execution policy unchanged. Group Policy, AllSigned, and constrained language configurations require your administrator-approved distribution process. Microsoft’s policy explanation ↗

Prepare once. Reuse on your managed PCs.

Automatic fleet enrollment.

Your administrator can prepare a private Windows Cloud Flipper script that installs, enrolls and starts the receiver after normal UAC approval. Each new PC creates its own fleet identity and appears after its first online check-in. Reinstalling preserves its identity and disabled setting.

The Mac and iPhone apps discover these machines in Cloud Fleet. The web portal discovers them after sign-in and import of your private command-keys.json. No code entry or profile editing is needed on each PC.

Public scripts below contain no fleet credentials and wait for enrollment. An existing PC showing waiting-for-enrollment needs the private script run once. Keep that private script on your administrator’s Flipper; never upload it to a public site.

Administrator toolkit and private fleet portal →

One Flipper. Your chosen tools.

Carry the right
install command.

Nine user scripts cover the three components and operating systems. A tenth script adds Windows administrator installation and startup for the Cloud Fleet receiver.

Browse all 10 ViperLink scripts ↓ · RedAgent desktop scripts →

  1. 01
    Copy to your Flipper

    Use qFlipper or the mobile app to place the .txt files in SD Card/badusb/. Close qFlipper afterward.

  2. 02
    Match mechanism, OS and keyboard

    For example, ViperLink-cloud-windows.txt installs the Cloud Fleet receiver files on Windows. Select USB mode and your computer’s keyboard layout.

  3. 03
    Unlock, connect and press Run

    Watch the terminal’s result. Follow START.txt to enroll the machine and start the tool when ready.

Linux assumes Ctrl+Alt+T opens a terminal; macOS uses Spotlight. First-use keyboard and USB prompts may need interaction. User installs require a separate runtime; the Windows administrator install includes one. Private enrollment is separate. Hardware timing on a physical Flipper has not been verified. Official Flipper instructions ↗

3. Enroll, start and stop

Windows administrator install — enrollment, status and removal

The administrator script installs for all users and starts the “Orbitus ViperLink Cloud” task as LocalService. It starts at boot without a login. The task is visible in Windows Task Scheduler. A one-minute recovery trigger restarts a stopped receiver and leaves an existing running instance alone. Private enrollment remains explicit.

  1. Stop any existing receiver using the same profile, including RedAgent. Preserve its journal when migrating.
  2. Place receiver.json, fleet-private.pem and any existing journal in %ProgramData%\Orbitus\ViperLink. The installing operator and administrators have access; ordinary users do not.
  3. Set the profile’s shared root to C:\ProgramData\Orbitus\ViperLink\Workspace, or another folder accessible to LocalService. Review the interval and set enabled=true when ready.
  4. Read startup-status.json in that directory for waiting-for-enrollment, disabled, checked-in or check-in-failed. Verify the authenticated receipt for actual job delivery.

To stop: disable the task in Task Scheduler and end its running instance. To remove: delete that task and %ProgramFiles%\Orbitus\ViperLink. Preserve or revoke enrollment separately. The receiver runs with LocalService permissions; installing it as administrator does not make every remote command an administrator command.

Cloud Fleet user install — foreground receiver
  1. Use the Fleet administrator toolkit to enroll a unique machine. Keep its receiver.json and fleet-private.pem in a private directory outside this installation.
  2. Review its shared folder and 1–1,440 minute interval. Create the shared directory, then deliberately set enabled to true in the private profile.
  3. In the installed component directory, run the foreground receiver below. Replace the profile path with your own absolute path; use a quoted Windows path on Windows.
node queue-agent.mjs --profile /absolute/private/receiver.json --watch

Use --once for one check-in. Ctrl+C stops the process; enabled=false prevents the next start. The user installer adds no service or login item. Keep only one receiver per profile, including RedAgent. Verify the authenticated receipt after queueing a job.

The Fleet transport key grants access to fleet records and belongs only on trusted managed machines. Per-machine keys protect command contents and receipts. CloudKit production activation remains separate from this pilot.

Status reporting only — send a report you prepare

Obtain the private reporting profile through the Fleet toolkit, prepare truthful status JSON, and validate locally from the installed directory:

node report-direct.mjs --profile /absolute/private/reporter-profile.json --report /absolute/status.json --validate

Omit --validate to send. The process exits after one report. This package does not include the command receiver or collect an application inventory. The reporting credential has fleet record access; package selection does not narrow that credential’s CloudKit permissions.

LAN / VPN controller — control an existing ViperLink host

Start an existing native ViperLink host and provision a private controller profile there. Place the profile on this machine and run from the installed directory:

python3 viperlink.py --profile /absolute/private/controller.json clients

On Windows use python and a quoted Windows path. Use --help for commands and choose the target explicitly. This Python tool is a controller; it does not turn Windows or Linux into a LAN execution target. The native Mac host and native Mac/iOS apps remain separate development builds. Choose Cloud Fleet commands when this machine should receive jobs.

Install locations, upgrades and removal

macOS: ~/Library/Application Support/Orbitus/ViperLink
Linux: ~/.local/share/Orbitus/ViperLink
Windows: %LOCALAPPDATA%\Programs\Orbitus\ViperLink

Each component has its own 0.4.0 directory. A repeat install verifies all packaged files and preserves unrelated directories; older versions remain intact. To remove a component, stop its foreground process and remove its versioned directory. Keep or revoke private enrollment separately. Removing installed files does not revoke a credential.

ViperLink or RedAgent?

Choose ViperLink for a focused remote tool. Choose RedAgent when you also need the desktop test and inventory workflow.

NeedViperLink source kitRedAgent workbench
InstallationOne selected source componentDesktop application with bundled Python and UI
Remote commandsOptional Cloud Fleet receiver; separate LAN controllerApp controls a persistent machine helper
Inventory and testsUse RedAgent for this workflowInstalled-app inventory, test plans and saved evidence
Download sizeCloud Fleet commands: 19.1 KiB ZIP
Status reporting only: 9.8 KiB ZIP
LAN / VPN controller: 4.5 KiB ZIP
macOS · Intel: 60.8 MiB
macOS · Apple Silicon: 59.7 MiB
Linux · x64: 93.7 MiB
Windows · x64: 57.3 MiB
Additional runtimeNode.js 22+ or Python 3.10+; runtime footprint is extraPython, UI and Node.js included

Install the full RedAgent workbench →

Release files and integrity

File manifest ↗
ComponentDownload / source footprintSHA-256
Cloud Fleet commandsViperLink-cloud-0.4.0.zip19552 bytes compressed · 50610 bytes source + notes
Show checksum04243de06acfee26f8b8b78ce4febe85c5223d87b09cb8b4910871b636bd3d46
Status reporting onlyViperLink-status-0.4.0.zip10052 bytes compressed · 25295 bytes source + notes
Show checksum18727242eac33bda862bd8f2b670cef35726a90dc0b14a8aa00c6d54e4c041ca
LAN / VPN controllerViperLink-lan-0.4.0.zip4588 bytes compressed · 11835 bytes source + notes
Show checksum3f52e5c2a2f6d9a255c4adf185302e56cef7c39f035f66fd1ca6a2b89457315c

Version 0.4.0 · 2026-11-11 · Source revision b0ce7131a3f1. Packages contain the selected public source from that revision. Installer CI checks source integrity, repeat installs and failure handling on macOS, Windows and Linux. Physical Flipper execution and Windows/Linux LAN interoperability remain unverified. These source packages are separate from signed native applications.