DraftPilot

VM Workflow

Run DraftPilot where the remote files live.

For remote experiments, launch DraftPilot on the VM and open it through a local SSH tunnel.

Requirements

  1. SSH access from your local machine to the VM.
  2. DraftPilot installed on the VM, either as a binary or source checkout.
  3. The VM can access the paper folder and codebase folder.
  4. Local machine has DraftPilot CLI installed to create the tunnel.

Launch command

draftpilot launch \
  --host user@vm.example.com \
  --app-dir /path/to/draftpilot-on-vm \
  --name PaperName \
  --paper /remote/path/to/paper \
  --codebase /remote/path/to/codebase \
  --open

How it works

Remote serverRuns beside the VM paper and codebase, so file paths are real VM paths.
Local tunnelThe local CLI opens an SSH tunnel and prints a local URL.
Browser/appYou view the UI locally while DraftPilot edits remote files.

Why CLI is better than desktop for VMs

The desktop app folder picker cannot browse VM-only paths unless they are mounted locally. The CLI can directly tell the VM where the paper and codebase live.