Enum CustomActionConfig 

pub enum CustomActionConfig {
    ShellCommand {
        id: String,
        title: String,
        command: String,
        args: Vec<String>,
        notify_on_success: bool,
        timeout_secs: u64,
        capture_output: bool,
        keybinding: Option<String>,
        prefix_char: Option<char>,
        keybinding_enabled: bool,
        description: Option<String>,
    },
    NewTab {
        id: String,
        title: String,
        command: Option<String>,
        keybinding: Option<String>,
        prefix_char: Option<char>,
        keybinding_enabled: bool,
        description: Option<String>,
    },
    InsertText {
        id: String,
        title: String,
        text: String,
        variables: HashMap<String, String>,
        keybinding: Option<String>,
        prefix_char: Option<char>,
        keybinding_enabled: bool,
        description: Option<String>,
    },
    KeySequence {
        id: String,
        title: String,
        keys: String,
        keybinding: Option<String>,
        prefix_char: Option<char>,
        keybinding_enabled: bool,
        description: Option<String>,
    },
    SplitPane {
        id: String,
        title: String,
        direction: ActionSplitDirection,
        command: Option<String>,
        command_is_direct: bool,
        focus_new_pane: bool,
        delay_ms: u64,
        split_percent: u8,
        keybinding: Option<String>,
        prefix_char: Option<char>,
        keybinding_enabled: bool,
        description: Option<String>,
    },
    Sequence {
        id: String,
        title: String,
        keybinding: Option<String>,
        prefix_char: Option<char>,
        keybinding_enabled: bool,
        description: Option<String>,
        steps: Vec<SequenceStep>,
    },
    Condition {
        id: String,
        title: String,
        keybinding: Option<String>,
        prefix_char: Option<char>,
        keybinding_enabled: bool,
        description: Option<String>,
        check: ConditionCheck,
        on_true_id: Option<String>,
        on_false_id: Option<String>,
    },
    Repeat {
        id: String,
        title: String,
        keybinding: Option<String>,
        prefix_char: Option<char>,
        keybinding_enabled: bool,
        description: Option<String>,
        action_id: String,
        count: u32,
        delay_ms: u64,
        stop_on_success: bool,
        stop_on_failure: bool,
    },
}

A custom action that can be triggered via keybinding.

Actions can execute shell commands, open a new tab, insert text, simulate key sequences, or split the active pane.

Variants

ShellCommand

Execute a shell command

Fields

id: String

Action identifier (for keybinding reference)

title: String

Human-readable title

command: String

Command to execute (e.g., “git”, “npm”)

args: Vec<String>

Command arguments (e.g., [“status”, “–short”])

notify_on_success: bool

Whether to show command output in a notification

timeout_secs: u64

Timeout in seconds for the command (default: 30)

capture_output: bool

Capture stdout+stderr into WorkflowContext for use by Sequence/Condition actions. When true, output is capped at 64 KB. Default: false.

keybinding: Option<String>

Optional keyboard shortcut to trigger the action (e.g., “Ctrl+Shift+R”)

prefix_char: Option<char>

Optional single character triggered after the global custom action prefix key.

keybinding_enabled: bool

Whether the keybinding is enabled (default: true)

description: Option<String>

Optional description

NewTab

Open a new tab and optionally run a command in its shell

Fields

id: String

Action identifier

title: String

Human-readable title

command: Option<String>

Optional command to send to the new tab’s shell after it opens

keybinding: Option<String>

Optional keyboard shortcut to trigger the action

prefix_char: Option<char>

Optional single character triggered after the global custom action prefix key.

keybinding_enabled: bool

Whether the keybinding is enabled (default: true)

description: Option<String>

Optional description

InsertText

Insert text into the terminal (like a snippet but no editing UI)

Fields

id: String

Action identifier

title: String

Human-readable title

text: String

Text to insert (supports variable substitution)

variables: HashMap<String, String>

Custom variables for substitution

keybinding: Option<String>

Optional keyboard shortcut to trigger the action

prefix_char: Option<char>

Optional single character triggered after the global custom action prefix key.

keybinding_enabled: bool

Whether the keybinding is enabled (default: true)

description: Option<String>

Optional description

KeySequence

Simulate a key sequence

Fields

id: String

Action identifier

title: String

Human-readable title

keys: String

Key sequence to simulate (e.g., “Ctrl+C”, “Up Up Down Down”)

keybinding: Option<String>

Optional keyboard shortcut to trigger the action

prefix_char: Option<char>

Optional single character triggered after the global custom action prefix key.

keybinding_enabled: bool

Whether the keybinding is enabled (default: true)

description: Option<String>

Optional description

SplitPane

Split the active pane and optionally send a command to the new pane

Fields

id: String

Action identifier

title: String

Human-readable title

direction: ActionSplitDirection

Split direction: horizontal (new pane below) or vertical (new pane right)

command: Option<String>

Command for the new pane.

Behaviour depends on command_is_direct:

• false (default): text is sent to the shell with a trailing newline after delay_ms.
• true: the string is split on whitespace and used as the pane’s initial process (like running htop directly). The pane closes when the process exits.

command_is_direct: bool

When true, command is the pane’s initial process (argv), not a shell command. The pane closes when the process exits. delay_ms is ignored. When false (default), command is sent as text to the shell.

focus_new_pane: bool

Whether to focus the new pane after splitting (default: true)

delay_ms: u64

Delay in ms before sending the command text to the new pane (default: 200). Only used when command_is_direct is false.

split_percent: u8

Percent of the current pane that the existing pane retains after the split. Range 10–90. Default: 66 (existing pane keeps 66%, new pane gets 34%).

keybinding: Option<String>

Optional keyboard shortcut to trigger the action

prefix_char: Option<char>

Optional single character triggered after the global custom action prefix key.

keybinding_enabled: bool

Whether the keybinding is enabled (default: true)

description: Option<String>

Optional description

Sequence

Run an ordered list of actions (steps) in sequence.

Fields

id: String

Action identifier

title: String

Human-readable title

keybinding: Option<String>

Optional keyboard shortcut

prefix_char: Option<char>

Optional single character triggered after the global custom action prefix key.

keybinding_enabled: bool

Whether the keybinding is enabled (default: true)

description: Option<String>

Optional description

steps: Vec<SequenceStep>

Ordered list of steps to execute.

Condition

Evaluate a condition and branch to different actions.

Fields

id: String

Action identifier

title: String

Human-readable title

keybinding: Option<String>

Optional keyboard shortcut

prefix_char: Option<char>

Optional single character triggered after the global custom action prefix key.

keybinding_enabled: bool

Whether the keybinding is enabled (default: true)

description: Option<String>

Optional description

check: ConditionCheck

The condition to evaluate.

on_true_id: Option<String>

Action ID to execute when check is true (standalone use only; ignored in Sequence).

on_false_id: Option<String>

Action ID to execute when check is false (standalone use only; ignored in Sequence).

Repeat

Execute an action repeatedly up to N times.

Fields

id: String

Action identifier

title: String

Human-readable title

keybinding: Option<String>

Optional keyboard shortcut

prefix_char: Option<char>

Optional single character triggered after the global custom action prefix key.

keybinding_enabled: bool

Whether the keybinding is enabled (default: true)

description: Option<String>

Optional description

action_id: String

ID of the action to repeat.

count: u32

Maximum number of repetitions (1–100).

delay_ms: u64

Delay in milliseconds between repetitions (default: 0).

stop_on_success: bool

Stop early when the action succeeds (default: false).

stop_on_failure: bool

Stop early when the action fails (default: false).

Implementations

impl CustomActionConfig

pub fn base(&self) -> ActionBase

Return a snapshot of the six shared base fields.

Use this to read multiple base fields at once without repeated match arms. For single-field reads, prefer the dedicated accessors (id(), title(), etc.).

pub fn apply_base(&mut self, base: ActionBase)

Overwrite all six shared base fields from an ActionBase snapshot.

This is the single mutation point that replaces the eight-arm match duplication previously found in set_keybinding, set_prefix_char, set_keybinding_enabled, and into_copy.

pub fn id(&self) -> &str

Get the action ID (for keybinding reference).

pub fn title(&self) -> &str

Get the action title (for UI display).

pub fn keybinding(&self) -> Option<&str>

Get the optional keybinding for this action.

pub fn prefix_char(&self) -> Option<char>

Get the optional prefix character for this action.

pub fn normalized_prefix_char(&self) -> Option<char>

Get the normalized prefix character for this action, if configured.

pub fn keybinding_enabled(&self) -> bool

Check if the keybinding is enabled.

pub fn set_keybinding(&mut self, kb: Option<String>)

Set the keybinding for this action.

pub fn set_prefix_char(&mut self, prefix_char: Option<char>)

Set the prefix character for this action.

pub fn set_keybinding_enabled(&mut self, enabled: bool)

Set whether the keybinding is enabled.

pub fn is_shell_command(&self) -> bool

Check if this is a shell command action.

pub fn is_new_tab(&self) -> bool

Check if this is a new tab action.

pub fn is_insert_text(&self) -> bool

Check if this is an insert text action.

pub fn is_key_sequence(&self) -> bool

Check if this is a key sequence action.

pub fn is_split_pane(&self) -> bool

Check if this is a split pane action.

pub fn is_sequence(&self) -> bool

Check if this is a sequence action.

pub fn is_condition(&self) -> bool

Check if this is a condition action.

pub fn is_repeat(&self) -> bool

Check if this is a repeat action.

pub fn into_copy(&self) -> CustomActionConfig

Produce a duplicate of this action suitable for “Clone” in the settings UI.

The returned action has:

• A fresh UUID-based id to avoid keybinding conflicts.
• The original title suffixed with "-copy".
• keybinding and prefix_char cleared to prevent immediate conflicts.

All other fields are deep-cloned from self.

This replaces the clone_action helper that was previously inlined in par-term-settings-ui/src/actions_tab.rs (see ARC-006). Keeping the logic here ensures it stays in sync with the Clone derive on CustomActionConfig.

Trait Implementations

impl Clone for CustomActionConfig

fn clone(&self) -> CustomActionConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CustomActionConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CustomActionConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<CustomActionConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for CustomActionConfig

fn eq(&self, other: &CustomActionConfig) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for CustomActionConfig

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CustomActionConfig