Struct SubprocessCliTransport 

pub struct SubprocessCliTransport {
    pub prompt: Prompt,
    pub options: ClaudeAgentOptions,
    pub cli_path: String,
    /* private fields */
}

Transport implementation that communicates with the Claude Code CLI via a subprocess.

Spawns the claude CLI as a child process, passing configuration via command-line arguments and environment variables. Communication uses newline-delimited JSON over stdin (input) and stdout (output).

CLI discovery

The CLI binary is located by:

1. Using cli_path from ClaudeAgentOptions if provided
2. Searching PATH for claude
3. Checking common installation locations (~/.npm-global/bin/, /usr/local/bin/, etc.)

Fields

prompt: Prompt

The prompt type for this transport session.

options: ClaudeAgentOptions

The agent options used to configure the CLI.

cli_path: String

The resolved path to the CLI executable.

Implementations

impl SubprocessCliTransport

pub fn new(prompt: Prompt, options: ClaudeAgentOptions) -> Result<Self>

Creates a new SubprocessCliTransport with the given prompt and options.

Resolves the CLI path immediately but does not start the subprocess. Call connect() to spawn the process.

Errors

Returns CLINotFoundError if the CLI executable cannot be located.

Example

use claude_code::transport::subprocess_cli::{Prompt, SubprocessCliTransport};

let _transport = SubprocessCliTransport::new(Prompt::Messages, Default::default()).unwrap();

pub fn build_command(&self) -> Result<Vec<String>>

Builds the complete command-line arguments for spawning the CLI process.

Translates all ClaudeAgentOptions fields into their corresponding CLI flags.

Returns

A Vec<String> where the first element is the CLI path and the rest are arguments.

Example

use claude_code::transport::subprocess_cli::{Prompt, SubprocessCliTransport};

let transport = SubprocessCliTransport::new(Prompt::Messages, Default::default()).unwrap();
let args = transport.build_command().unwrap();
assert!(args.iter().any(|arg| arg == "--input-format"));

Trait Implementations

impl Drop for SubprocessCliTransport

fn drop(&mut self)

Executes the destructor for this type.

impl Transport for SubprocessCliTransport

fn connect<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Establishes the transport connection (e.g., spawns the subprocess).

fn write<'life0, 'life1, 'async_trait>( &'life0 mut self, data: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Writes a string (typically a JSON line) to the CLI’s input stream.

fn end_input<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Signals that no more input will be sent (closes the input stream).

fn read_next_message<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<Option<Value>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Reads the next JSON message from the CLI’s output stream.

fn close<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Closes the transport connection and cleans up resources.

fn is_ready(&self) -> bool

Returns true if the transport is connected and ready for I/O.

fn into_split(self: Box<Self>) -> TransportSplitResult

Splits the transport into independent reader and writer halves.