[frances720]

Feature

PIG host enrollment now works on headless servers and SSH-only machines via the --device flag. The host prints an approval URL; a developer opens it on any device with a browser and approves. No local browser, inbound port, or loopback callback required on the host.

Entries considered this run

Window: 2026-09-28 → 2026-10-05.

#	Entry	Decision	Reason
1	Enroll hosts that have no browser — Run enroll --device, open the printed approval link on another device and approve the host there	QUALIFIES	Adds substantial new capability: unlocks host enrollment for a class of machines (headless servers, SSH-only hosts, cloud VMs) where enrollment was previously impossible
2	Find suggestions by source PR number — Search the suggestions list with source-pr:123 to find suggestions triggered by a specific source PR or MR	SKIP	Expanded search filter on an existing capability; does not open a substantially new workflow

2 commit(s) in window. 2 entries considered, 1 qualified.

Covered entry (full text)

Enroll hosts that have no browser: You can now enroll a PIG host you reach over SSH, or any other host without a local browser. Run the host runtime's enroll command with --device, then open the printed approval link on another device and approve the host there. See Enroll your hosts.

Source: commit f595e04.

PR(s) researched

• Promptless/promptless#5250 — Allow host enrollment from a browser on another device

File

src/content/blog/product-updates/headless-host-enrollment.mdx

AI-generated draft — needs human review before publishing.

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
promptless-docs	Ready	Preview	Oct 5, 2026 2:16pm UTC

[promptless]

Promptless inbound docs review: I checked correctness against Enroll your hosts (merged in #1056) and the source PRs, plus style and frontmatter against the other product-updates posts.

Verdict: comment. Accurate: the command (python3 "$PIG_PLUGIN_ROOT/runtime/promptless-host-runtime" enroll --host codex --device), the ~35-second poll, setup_pending resume, the 15-minute expiry, the --host values, and the prerequisites in "How to use it". Frontmatter and components match the existing launch posts.

1. Release state (blocking for publish). Both source PRs behind --device are still open and undeployed: the client flag in Promptless/pig-toolchain#98 and the backend device-sessions endpoint in Promptless/promptless#5250. #5250 also has a mandatory rollout gate (Service change, backend deploy, then enabling the client). Until both merge and ship in a released pig plugin, enroll --device won't work for readers, so this post shouldn't merge before then. When it does go out, update subtitle/date to the real publish date; right now they say September 28.
2. Duplicate launch post. #1105 (browserless-host-enrollment.mdx) announces the same --device feature and is open at the same time. Only one should merge, so a maintainer should pick one and close the other. Of the two, this one is more accurate: it uses the real bundled-runtime invocation and states the prerequisites.
3. One inaccuracy about how standard enrollment works (inline).

[promptless]

Inaccurate: standard enrollment doesn't open a browser tab at 127.0.0.1. The browser opens the approval page at app.gopromptless.ai/instruction-hub/enroll, and the runtime listens on a local 127.0.0.1 callback while approval completes (see Enroll your hosts, step 3). Suggested wording:

Standard enrollment opens the Promptless approval page in a browser on the host and completes through a local 127.0.0.1 callback.

Also, "X forwarding or manual credential handling" isn't backed by any source, and the guide says not to copy host credentials between machines. I'd cut that clause or replace it with "port-forwarding the loopback callback".

[InlinePizza]

Closing: the automated content pipeline is being turned off and these generated drafts will not be merged. The branch is left in place in case anything is worth salvaging.