CLI

The agent-friendly DraftPilot interface.

Use the CLI for VM workflows, headless machines, repeatable launches, and Codex/agent automation.

Install

macOS and Linux

curl -fsSL https://jerrinbright.com/draftpilot/install.sh | bash

The shell installer detects macOS arm64 or Linux x64, downloads the right CLI archive, verifies its checksum, installs to ~/.draftpilot/bin/draftpilot, and prints launch examples.

Windows

powershell -ExecutionPolicy Bypass -Command "irm https://jerrinbright.com/draftpilot/install.ps1 | iex"

The PowerShell installer downloads the Windows x64 CLI zip, verifies its checksum, installs draftpilot.cmd to %USERPROFILE%\.draftpilot\bin, and adds that folder to the user PATH.

macOS arm64

curl -L -o draftpilot-0.1.1-macos-arm64.tar.gz https://draftpilot-releases.jerriebright.workers.dev/releases/draftpilot-0.1.1-macos-arm64.tar.gz
tar -xzf draftpilot-0.1.1-macos-arm64.tar.gz
chmod +x draftpilot-macos-arm64
sudo mv draftpilot-macos-arm64 /usr/local/bin/draftpilot

Linux x64

curl -L -o draftpilot-0.1.1-linux-x64.tar.gz https://draftpilot-releases.jerriebright.workers.dev/releases/draftpilot-0.1.1-linux-x64.tar.gz
tar -xzf draftpilot-0.1.1-linux-x64.tar.gz
chmod +x draftpilot-linux-x64
sudo mv draftpilot-linux-x64 /usr/local/bin/draftpilot

Windows x64

curl.exe -L -o draftpilot-0.1.1-windows-x64.zip https://draftpilot-releases.jerriebright.workers.dev/releases/draftpilot-0.1.1-windows-x64.zip
powershell -NoProfile -Command "Expand-Archive -Force draftpilot-0.1.1-windows-x64.zip ."
.\draftpilot-windows-x64.exe help

Launch locally

draftpilot launch \
  --paper /path/to/latex-paper \
  --codebase /path/to/research-code \
  --open

Useful commands

draftpilot status
draftpilot logs --tail 120
draftpilot doctor --paper /path/to/latex-paper --codebase /path/to/codebase
draftpilot stop
draftpilot update

Anonymous telemetry

DraftPilot can send best-effort anonymous install and command events when internet is available. It does not send paper content, LaTeX source, file paths, codebase paths, PDF content, comments, highlighted text, compile logs, SSH hosts, Git remotes, usernames, API keys, or environment variables.

The telemetry endpoint may store event name, version, platform, OS, architecture, anonymous install ID, command success/failure, duration, coarse error category, timezone, locale, and Cloudflare-derived coarse location such as country, region, city, timezone, colo, and continent.

DRAFTPILOT_TELEMETRY=0 draftpilot launch --paper ./paper --codebase ./repo

Agent JSON mode

Use --json when Codex or another agent needs parseable output.

draftpilot launch --paper ./paper --codebase ./repo --json
draftpilot status --json
draftpilot logs --tail 80 --json