Struct Runner 

pub struct Runner {
    pub mode: RunnerMode,
    pub wsl_options: WslOptions,
    pub buffer_config: BufferConfig,
}

Runner for cross-platform Claude CLI execution with automatic detection

Fields

mode: RunnerMode

The execution mode to use

wsl_options: WslOptions

WSL-specific configuration options

buffer_config: BufferConfig

Output buffering configuration

Implementations

impl Runner

pub fn detect_auto() -> Result<RunnerMode, RunnerError>

Detect the best runner mode automatically

On Windows:

1. Try claude --version on PATH -> Native if succeeds
2. Else try wsl -e claude --version -> WSL if returns 0
3. Else: friendly preflight error suggesting wsl --install if needed

On Linux/macOS: always Native

pub fn test_native_claude() -> Result<(), RunnerError>

Test if native Claude CLI is available

pub fn test_wsl_claude() -> Result<(), RunnerError>

Test if WSL Claude CLI is available

pub fn validate(&self) -> Result<(), RunnerError>

Validate the runner configuration

pub fn description(&self) -> String

Get a user-friendly description of the runner configuration

impl Runner

pub fn new(mode: RunnerMode, wsl_options: WslOptions) -> Self

Create a new Runner with the specified mode and options

pub const fn with_buffer_config( mode: RunnerMode, wsl_options: WslOptions, buffer_config: BufferConfig, ) -> Self

Create a new Runner with custom buffer configuration

pub fn parse_ndjson(stdout: &str) -> NdjsonResult

Parse NDJSON output from Claude CLI

Treats stdout as NDJSON where each line is a JSON object. Returns the last valid JSON object found, or NoValidJson with a tail excerpt.

Arguments

• stdout - The stdout content to parse

Returns

• NdjsonResult::ValidJson - If at least one valid JSON object was found (returns the last one)
• NdjsonResult::NoValidJson - If no valid JSON was found (includes tail excerpt for error reporting)

pub fn native() -> Self

Create a Runner with native mode

pub fn auto() -> Result<Self, RunnerError>

Create a Runner with automatic detection

The runner will be in Auto mode and will detect the appropriate concrete mode (Native or WSL) during execution.

Internal API

This is an internal helper for future use. The CLI only supports native and wsl modes via --runner-mode. Auto mode detection is handled internally when the config specifies runner_mode = "auto", but goes through Runner::with_buffer_config().

pub async fn execute_claude( &self, args: &[String], stdin_content: &str, timeout_duration: Option<Duration>, ) -> Result<ClaudeResponse, RunnerError>

Execute Claude CLI with the configured runner mode

Uses wsl.exe --exec with argv (no shell) for WSL execution and pipes packet via STDIN. Records runner_distro from wsl -l -q or $WSL_DISTRO_NAME for WSL mode.

impl Runner

pub fn get_claude_version_sync(&self) -> Result<String, RunnerError>

Get the Claude CLI version synchronously, respecting runner mode

This method is used during initialization to capture the Claude CLI version without requiring an async runtime. It correctly routes through WSL when the runner is configured for WSL mode.

Returns

• Ok(String) - The version string (e.g., “0.8.1”)
• Err(RunnerError) - Failed to execute or parse version

impl Runner

pub fn get_wsl_distro_name(&self) -> Option<String>

Get the WSL distro name from wsl -l -q or $WSL_DISTRO_NAME

Trait Implementations

impl Clone for Runner

fn clone(&self) -> Runner

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Runner

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Runner

fn default() -> Self

Returns the “default value” for a type.