Skip to main content

Module headless

Module headless 

Source
Expand description

Headless one-shot mode: microclaw run -p "<prompt>".

Runs a single prompt through the shared agent loop without starting any channel, prints the final reply to stdout, and exits non-zero on failure — the scripting/CI entry point (grok-build’s headless mode equivalent). Runs share the headless channel; --session <name> selects a named chat so consecutive runs can keep conversation context.

Structs§

HeadlessRunExecutor
Adapter from the existing shared Agent Engine to the embeddable Runtime contract.
HeadlessRunRequest
HeadlessRunResult
HeadlessRuntime
Reusable application service for one-shot tasks.
HeadlessSubagentRun
UI-neutral projection of one durable Subagent run.

Constants§

HEADLESS_CHANNEL
WORK_CHANNEL

Functions§

run_once