Struct ForkCommand 

pub struct ForkCommand { /* private fields */ }

Fork a previous interactive Codex session, creating a new branch of conversation.

Implementations

impl ForkCommand

pub fn new() -> Self

pub fn session_id(self, id: impl Into<String>) -> Self

Session ID (UUID) to fork.

pub fn prompt(self, prompt: impl Into<String>) -> Self

Optional prompt to start the forked session with.

pub fn last(self) -> Self

Fork the most recent session without showing the picker.

pub fn all(self) -> Self

Show all sessions (disables cwd filtering).

pub fn config(self, key_value: impl Into<String>) -> Self

pub fn enable(self, feature: impl Into<String>) -> Self

pub fn disable(self, feature: impl Into<String>) -> Self

pub fn image(self, path: impl Into<String>) -> Self

pub fn model(self, model: impl Into<String>) -> Self

pub fn oss(self) -> Self

pub fn local_provider(self, provider: impl Into<String>) -> Self

pub fn profile(self, profile: impl Into<String>) -> Self

pub fn sandbox(self, sandbox: SandboxMode) -> Self

pub fn approval_policy(self, policy: ApprovalPolicy) -> Self

pub fn full_auto(self) -> Self

Run in full-auto mode, emitted as --sandbox workspace-write.

codex fork rejects --full-auto outright in codex-cli 0.145.0 (“unexpected argument”), so this emits the replacement the CLI names for the exec family. An explicit sandbox call is more specific and wins over it.

pub fn approve_for_me(self) -> Self

Route approval requests through automatic review, using the workspace-write sandbox (--approve-for-me).

Added in codex-cli 0.147.0. Older releases reject it as an unexpected argument, so this is the one builder method with a floor above the wrapper’s tested minimum. codex exec review and codex exec resume do not accept it.

pub fn strict_config(self) -> Self

Error on unrecognized config keys (--strict-config).

pub fn no_alt_screen(self) -> Self

Do not use the terminal alternate screen (--no-alt-screen).

pub fn remote(self, addr: impl Into<String>) -> Self

Connect the TUI to a remote app server endpoint (--remote <ADDR>).

pub fn remote_auth_token_env(self, env_var: impl Into<String>) -> Self

Env var holding the bearer token for the remote app server (--remote-auth-token-env <ENV_VAR>).

pub fn cd(self, dir: impl Into<String>) -> Self

pub fn search(self) -> Self

Enable live web search.

pub fn add_dir(self, dir: impl Into<String>) -> Self

Trait Implementations

impl Clone for ForkCommand

fn clone(&self) -> ForkCommand

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl CodexCommand for ForkCommand

type Output = CommandOutput

The type returned on success.

fn args(&self) -> Vec<String>

Build the argument list for this command.

async fn execute(&self, codex: &Codex) -> Result<CommandOutput>

Execute the command against the given Codex client.

fn to_command_string(&self, codex: &Codex) -> String

Render the exact command line this builder will spawn, quoted for a POSIX shell.

impl Dangerous for ForkCommand

fn bypass_approvals_and_sandbox(self, _allow: &DangerousClient) -> Result<Self>

Disable every approval prompt and the sandbox (--dangerously-bypass-approvals-and-sandbox).

fn bypass_hook_trust(self, _allow: &DangerousClient) -> Result<Self>

Let configured hooks run without the trust prompt (--dangerously-bypass-hook-trust).

impl Debug for ForkCommand

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

Formats the value using the given formatter.

impl Default for ForkCommand

fn default() -> Self

Returns the “default value” for a type.