remote-launcherlisted

Use when the user wants to operate one or more remote Linux hosts from Claude Code on the Mac while keeping Anthropic credentials only on the Mac. Triggers include deploying multi-container labs on a remote VM, coordinating one agent across multiple VMs (e.g., web VM + DB VM), running multi-agent setups (e.g., "you are Agent 1") against a remote host, executing builds/tests/sysadmin on a target machine via SSH, working with infrastructure where files must live on the VM. Activation typically means telling the user to launch via `remote-launcher <host>` (or `remote-launcher host1 --host host2` for multi-host) instead of plain `claude`. Do NOT use for local-only work or tasks that don't involve a target host.
foxfollow/remote-launcher · ★ 1 · DevOps & Infrastructure · score 67

Install: claude install-skill foxfollow/remote-launcher

# remote-launcher skill Operate a remote Linux host from Claude Code on the Mac, keeping Anthropic OAuth on the Mac. ## When applicable User says things like: - "Deploy this on the VM" - "I have a sandbox at <host>, run X there" - "Set up containers on <host>" - "You are Agent N" (multi-agent scenario targeting a VM) - "Use the lab VM" / "use my dev box" ## How to activate Tell the user to launch via the launcher: ``` remote-launcher <ssh-host> ``` For multi-host (one agent coordinating across two or three VMs): ``` remote-launcher <host1> --host <host2> [--host <host3>] ``` Inside Claude, route a Bash call to a specific host with `@<host>` as the first token (e.g. `@host2 ls /var`). Without a prefix, the command goes to `<host1>` (the default). Or with a task pre-loaded: ``` remote-launcher <ssh-host> --task ~/path/to/PROMPT.md ``` The launcher sets `CLAUDE_CODE_SHELL` (Bash → VM) and appends a system-prompt block that explains the operating mode. The user then pastes their task / role assignment normally. ## Diagnostics ``` remote-launcher-doctor # files / PATH check remote-launcher-doctor <ssh-host> # also live SSH + wrapper round-trip ``` ## Architecture - `bin/ssh-shell` — `CLAUDE_CODE_SHELL` wrapper. SSH ControlMaster, tracks cwd between calls. - `bin/remote-launcher` — launcher: tests SSH, sets env, exec's claude with `--append-system-prompt`. - `prompts/REMOTE_PROMPT.md` — instructs the model on Bash→VM and Read/Edit/Write→Mac discipline