marble-peer v0.1.2

Pre-built marble-peer binaries built on GitHub Actions (CGO_ENABLED=0). Unsigned portable files — no .dmg, notarization or Authenticode signing.

Linux targets compile on ubuntu-latest. macOS targets compile on macos-latest (not Linux cross-compile). Windows targets compile on windows-latest.

Desktop agent for Marble remote computer-use (ADR-0020 / ADR-0021).

Asset	Platform
marble-peer-linux-amd64	Linux x86_64
marble-peer-linux-arm64	Linux aarch64
marble-peer-darwin-arm64	macOS Apple Silicon
marble-peer-darwin-amd64	macOS Intel
marble-peer-windows-amd64.exe	Windows 10/11 x64
marble-peer-windows-arm64.exe	Windows 11 on ARM

curl -fsSL -O https://github.com/rendicott/marble-desktop-peer/releases/latest/download/marble-peer-darwin-arm64
curl -fsSL -O https://github.com/rendicott/marble-desktop-peer/releases/latest/download/SHA256SUMS
grep marble-peer-darwin-arm64 SHA256SUMS | shasum -a 256 -c -
chmod +x marble-peer-darwin-arm64
xattr -d com.apple.quarantine marble-peer-darwin-arm64 2>/dev/null || true
./marble-peer-darwin-arm64 version
./marble-peer-darwin-arm64 doctor

Windows

⚠️ Windows Defender quarantines this binary. It is unsigned, and Defender's ML heuristic flags it as Trojan:Win32/Bearfoos.A!ml — a false positive (the !ml suffix means a shape-based guess, not a signature match). Defender deletes the file, so marble-peer.exe vanishes and every command fails with The term 'marble-peer' is not recognized. Add an exclusion for the install directory first, then install.

Step 1 — exclude the install directory (run in an admin PowerShell):

Add-MpPreference -ExclusionPath "$env:USERPROFILE\.local\bin"

Step 2 — download, verify, and install (normal PowerShell):

$ProgressPreference = 'SilentlyContinue'
$base = 'https://github.com/rendicott/marble-desktop-peer/releases/latest/download'
$dir  = "$env:USERPROFILE\.local\bin"
New-Item -ItemType Directory -Force $dir | Out-Null

Invoke-WebRequest "$base/marble-peer-windows-amd64.exe" -OutFile "$dir\marble-peer.exe"
Invoke-WebRequest "$base/SHA256SUMS" -OutFile "$env:TEMP\SHA256SUMS"

# verify the checksum before trusting the download
$want = ((Select-String -Path "$env:TEMP\SHA256SUMS" -Pattern 'marble-peer-windows-amd64.exe' -SimpleMatch).Line -split '\s+')[0]
$got  = (Get-FileHash "$dir\marble-peer.exe" -Algorithm SHA256).Hash.ToLower()
if ($got -ne $want) { throw "checksum mismatch: $got vs $want" }

Unblock-File "$dir\marble-peer.exe"
[Environment]::SetEnvironmentVariable('Path', "$([Environment]::GetEnvironmentVariable('Path','User'));$dir", 'User')
$env:Path += ";$dir"

Step 3 — verify it runs:

marble-peer version
marble-peer doctor

Use marble-peer-windows-arm64.exe on Windows on ARM.

If Defender already ate the file, confirm and clean up:

Get-MpThreat | Select-Object ThreatName,SeverityID,IsActive | Format-List
# expect: Trojan:Win32/Bearfoos.A!ml

Then re-run step 2. To undo the exclusion later: Remove-MpPreference -ExclusionPath "$env:USERPROFILE\.local\bin".

Please report the false positive so future releases stop getting flagged: https://www.microsoft.com/en-us/wdsi/filesubmission (submit as software developer → incorrect detection).

Windows needs an interactive session. Plain SSH lands in session 0, which has no desktop — screenshot and input are impossible there. Install over SSH if you like, but run the peer from a console/RDP session, install-autostart, or a scheduled task created with schtasks ... /it. doctor detects this and says so (lock: locked=true source=session).

Linux desktop tools (recommended): xdotool, gnome-screenshot (or ImageMagick import).
macOS install: chmod +x → xattr -d com.apple.quarantine (unsigned download) → move to ~/.local/bin/marble-peer → marble-peer doctor --open-settings → grant Screen Recording and Accessibility. See the README.
Windows install: no extra packages; see the README (input into elevated windows needs an elevated peer).
Chrome required for browser automation (CDP mirror profile under ~/.marble-peer).

See the README for pair, run, tray, and autostart.

marble-peer v0.1.1

Pre-built marble-peer binaries built on GitHub Actions (CGO_ENABLED=0). Unsigned portable files — no .dmg or notarization.

Linux targets compile on ubuntu-latest. macOS targets compile on macos-latest (not Linux cross-compile).

Desktop agent for Marble remote computer-use (ADR-0020 / ADR-0021).

Asset	Platform
marble-peer-linux-amd64	Linux x86_64
marble-peer-linux-arm64	Linux aarch64
marble-peer-darwin-arm64	macOS Apple Silicon
marble-peer-darwin-amd64	macOS Intel

chmod +x marble-peer-darwin-arm64
./marble-peer-darwin-arm64 version
./marble-peer-darwin-arm64 doctor

Verify:

sha256sum -c SHA256SUMS

Linux desktop tools (recommended): xdotool, gnome-screenshot (or ImageMagick import).
macOS install: chmod +x → xattr -d com.apple.quarantine (unsigned download) → move to ~/.local/bin/marble-peer → marble-peer doctor --open-settings → grant Screen Recording and Accessibility. See the README.
Chrome required for browser automation (CDP mirror profile under ~/.marble-peer).

See the README for pair, run, tray, and autostart.

Full Changelog: v0.1.0...v0.1.1

marble-peer v0.1.0

Pre-built marble-peer binaries built on GitHub Actions (CGO_ENABLED=0).

Desktop agent for Marble remote computer-use (ADR-0020 / ADR-0021).

Asset	Platform
marble-peer-linux-amd64	Linux x86_64
marble-peer-linux-arm64	Linux aarch64
marble-peer-darwin-arm64	macOS Apple Silicon

chmod +x marble-peer-linux-amd64
./marble-peer-linux-amd64 version
./marble-peer-linux-amd64 -h   # if supported; else pair / run / status

Verify:

sha256sum -c SHA256SUMS

Linux desktop tools (recommended): xdotool, gnome-screenshot (or ImageMagick import).
Chrome required for browser automation (CDP mirror profile under ~/.marble-peer).

See the README for pair, run, tray, and autostart.

Full Changelog: https://github.com/rendicott/marble-desktop-peer/commits/v0.1.0