Struct CliBackend 

pub struct CliBackend {
    pub command: String,
    pub args: Vec<String>,
    pub prompt_mode: PromptMode,
    pub prompt_flag: Option<String>,
    pub output_format: OutputFormat,
}

A CLI backend configuration for executing prompts.

Fields

command: String

The command to execute.

args: Vec<String>

Additional arguments before the prompt.

prompt_mode: PromptMode

How to pass the prompt.

prompt_flag: Option<String>

Argument flag for prompt (if prompt_mode is Arg).

output_format: OutputFormat

Output format emitted by this backend.

Implementations

impl CliBackend

pub fn from_config(config: &CliConfig) -> Result<Self, CustomBackendError>

Creates a backend from configuration.

Errors

Returns CustomBackendError if backend is “custom” but no command is specified.

pub fn claude() -> Self

Creates the Claude backend.

Uses -p flag for headless/print mode execution. This runs Claude in non-interactive mode where it executes the prompt and exits. For interactive mode, stdin is used instead (handled in build_command).

Emits --output-format stream-json for NDJSON streaming output. Note: --verbose is required when using --output-format stream-json with -p.

pub fn claude_tui() -> Self

Creates the Claude TUI backend for interactive mode.

Runs Claude in full interactive mode (no -p flag), allowing Claude’s native TUI to render. The prompt is passed as a positional argument.

Unlike the standard claude() backend:

• No -p flag (enters interactive TUI mode)
• No --output-format stream-json (raw terminal output)
• Prompt is a positional argument, not a flag value

pub fn kiro() -> Self

Creates the Kiro backend.

Uses kiro-cli in headless mode with all tools trusted.

pub fn kiro_with_agent(agent: String) -> Self

Creates the Kiro backend with a specific agent.

Uses kiro-cli with –agent flag to select a specific agent.

pub fn from_name(name: &str) -> Result<Self, CustomBackendError>

Creates a backend from a named backend string.

Errors

Returns error if the backend name is invalid.

pub fn from_hat_backend( hat_backend: &HatBackend, ) -> Result<Self, CustomBackendError>

Creates a backend from a HatBackend configuration.

Errors

Returns error if the backend configuration is invalid.

pub fn gemini() -> Self

Creates the Gemini backend.

pub fn codex() -> Self

Creates the Codex backend.

pub fn amp() -> Self

Creates the Amp backend.

pub fn custom(config: &CliConfig) -> Result<Self, CustomBackendError>

Creates a custom backend from configuration.

Errors

Returns CustomBackendError if no command is specified.

pub fn build_command( &self, prompt: &str, interactive: bool, ) -> (String, Vec<String>, Option<String>, Option<NamedTempFile>)

Builds the full command with arguments for execution.

Arguments

• prompt - The prompt text to pass to the agent
• interactive - Whether to run in interactive mode (affects agent flags)

Trait Implementations

impl Clone for CliBackend

fn clone(&self) -> CliBackend

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CliBackend

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

Formats the value using the given formatter.