werkregie/doc/prs/2026-10-14-PR#71-satellite-spike.md

PR#71: An Omarchy Satellite in a VM, Tried by Hand

WARNING: This document describes only the change applied in this PR. It may already be outdated once the next PR is merged. Historic PR documentation is not maintained along with new PRs; treat it as a snapshot.

Related Links

• werkregie PR#57: the plan for satellites, #sat.

Problem

#sat.apply assumes that an Omarchy desktop with Claude Desktop, reached over RDP, works as a satellite. Two points were open: Anthropic supports Claude Desktop on Linux only on Debian and Ubuntu, as a beta, and RDP into a Hyprland session is not standard. Setting up the first VM by hand showed that typing into a VM without a clipboard is slow and error-prone.

Non-Goals

• No code; satellite apply and satellite vm follow in their own PRs.
• No test of the Code tab of Claude Desktop and of a frontend preview in the satellite.

Solution

• doc/satellite-omarchy.md: the steps that made sat-werk1 on think a satellite, with each pitfall found.
• doc/satellite-inventory.md links the new document.
• #sat in doc/werkregie.werkbaum: the spike as done, a new node for the unattended VM, and what it changes in the other nodes.
• Version 0.43.1.

Open Questions

• None.