Function run_headless

src/entrypoints/headless.py:108–482

Run one or more prompts in headless mode. Returns the exit code.

(options: HeadlessOptions)

def run_headless(options: HeadlessOptions) -> int:
    """Run one or more prompts in headless mode. Returns the exit code."""

    if options.output_format not in OUTPUT_FORMATS:
        cli_error(
            f"error: --output-format must be one of {', '.join(OUTPUT_FORMATS)}", 2
        )
    if options.input_format not in INPUT_FORMATS:
        cli_error(
            f"error: --input-format must be one of {', '.join(INPUT_FORMATS)}", 2
        )
    if options.input_format == "stream-json" and options.output_format != "stream-json":
        cli_error(
            "error: --input-format stream-json requires --output-format stream-json",
            2,
        )

    stdout = options.stdout or sys.stdout
    stderr = options.stderr or sys.stderr
    stdin = options.stdin or sys.stdin

    # ch02 round-3 GAP B: warm the user/system context memos now so the
    # CLAUDE.md walk and git probes overlap with provider + registry
    # construction below instead of running inside the first turn.
    # Mirrors TS main.tsx:1973-1990 (non-interactive early kicks; trust
    # is implicit in -p mode and was granted by run_pre_action).
    # MUST use the resolved workspace_root, not the process cwd — the
    # memos are key-less and first-writer pins the content the query
    # path (which passes workspace_root) will read.
    workspace_root = options.workspace_root or Path.cwd()
    from src.deferred_init import start_deferred_prefetches

    start_deferred_prefetches(cwd=str(workspace_root))

    provider_name = options.provider_name or get_default_provider()
    try:
        provider_cfg = get_provider_config(provider_name)
    except Exception as exc:
        cli_error(f"error: unable to load provider config: {exc}", 2)
    # Config api_key wins; fall back to the provider's known env vars (e.g.
    # ``DEEPSEEK_API_KEY``) so a freshly-added provider works without ``login``.
    # Local providers (Ollama / vLLM / SGLang) need no key.
    api_key = resolve_api_key(provider_name, provider_cfg)
    if not api_key and provider_requires_api_key(provider_name):
        cli_error(
            f"error: API key for provider '{provider_name}' is not configured. "
            "Run `clawcodex login` to set it up.",
            2,
        )

    provider_cls = get_provider_class(provider_name)
    model = options.model or provider_cfg.get("default_model")
    provider = provider_cls(
        api_key=api_key,
        base_url=provider_cfg.get("base_url"),
        model=model,
    )