A Linux box faster than your MacBook.

Install the CLI

On a pristine Mac (Apple Silicon) or Linux x86_64, install the CLI (and step) with no Nix. Or install Nix and skip this — every command can be nix run github:juspay/xyne-boxes instead.

$curl -fsSL https://raw.githubusercontent.com/juspay/xyne-boxes/nightly/installer/install.sh | sh

Install Tailscale

You need the Tailscale CLI so you can join the Juspay network. On macOS, install it from the Mac App Store. On Linux, use the official Linux packages or your distro’s Tailscale module. tailscale --help should print something.

$mkdir -p /usr/local/bin
printf '#!/bin/sh\nexec /Applications/Tailscale.app/Contents/MacOS/Tailscale "$@"\n' > /usr/local/bin/tailscale
chmod +x /usr/local/bin/tailscale

Join the network

This opens a browser so you can sign in.

$sudo tailscale up --login-server=https://headscale.nixos.asia --hostname $(hostname -s)

Create it

$xyne-boxes create <name>

Connect

$xyne-boxes connect <name>

$eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

$mkdir -p ~/.ssh
touch ~/.ssh/config
grep -qxF 'Include ~/.pu-state/*/ssh_config' ~/.ssh/config \
  || { { printf 'Include ~/.pu-state/*/ssh_config\n\n'; cat ~/.ssh/config; } > ~/.ssh/config.new \
        && mv ~/.ssh/config.new ~/.ssh/config; }

Open in VS Code optional

Edit and debug on the box from your laptop. Install the Remote - SSH extension (or the Remote Development pack). Microsoft’s SSH guide and tutorial walk through the UI.

VS Code uses your SSH config, so do the Prefer ssh <name> instead of connect step once. Then in VS Code: Command Palette → Remote-SSH: Connect to Host… → pick <name> → open a folder. The workspace is the box, not your MacBook.