headless-run

name	headless-run
description	Run a Claude Code skill or command headlessly in an isolated subprocess — fresh session id, clean HOME and config dir, scrubbed env, JSON result, timeout. Use for scripted one-shot invocations and benchmark-harness cases (e.g. running /code-review once per case), to run an isolated claude -p, or to avoid a nested run reusing the parent Remote session identity or tool surface. Trigger phrases include "run a skill headlessly", "isolated claude -p", "benchmark harness invocation", "run /code-review headlessly", "run it once per case", and "avoid nested session reuse".
argument-hint	<prompt-or-slash-command> [--cwd DIR] [--model MODEL] [--timeout SECS]
user-invocable	true
allowed-tools	Read, Bash

Headless Run

Role: worker. This skill runs one Claude Code prompt in a maximally isolated subprocess and returns its JSON result — it does not review, plan, or edit.

When to use it

Use it for scripted, one-shot headless invocations — above all a benchmark harness that shells out to claude -p per case (the #821 harness that runs /code-review once per fixture). A plain nested claude -p launched inside a live Claude Code Remote session inherits the parent's identity and tool surface (see and issue #842):