Enum EditingMode 

pub enum EditingMode {
    Edit,
    Plan,
    Agent,
}

Default editing mode for agent startup (Codex-inspired workflow)

Controls the initial mode when a session starts. This is a configuration enum for default_editing_mode in vtcode.toml. At runtime, the mode can be cycled (Edit → Plan → Agent → Edit) via Shift+Tab or /plan, /agent commands.

Inspired by OpenAI Codex’s emphasis on structured planning before execution, but provider-agnostic (works with Gemini, Anthropic, OpenAI, xAI, DeepSeek, etc.)

Variants

Edit

Full tool access - can read, write, execute commands (default) Use for: Implementation, bug fixes, feature development

Plan

Read-only exploration - mutating tools blocked Use for: Planning, research, architecture analysis Agent can write plans to .vtcode/plans/ but not modify code

Agent

Autonomous agent mode - full tool access with reduced HITL prompts Use for: Long-running autonomous tasks with minimal interruption

Implementations

impl EditingMode

pub fn as_str(self) -> &'static str

Return the textual representation for configuration and display

pub fn parse(value: &str) -> Option<Self>

Parse editing mode from user configuration input

pub fn allowed_values() -> &'static [&'static str]

Enumerate the allowed configuration values for validation

pub fn can_modify_files(self) -> bool

Check if this mode allows file modifications

pub fn can_execute_commands(self) -> bool

Check if this mode allows command execution

pub fn is_read_only(self) -> bool

Check if this is read-only planning mode

pub fn is_autonomous(self) -> bool

Check if this is autonomous agent mode (reduced HITL)

Trait Implementations

impl Clone for EditingMode

fn clone(&self) -> EditingMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EditingMode

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

Formats the value using the given formatter.

impl Default for EditingMode

fn default() -> EditingMode

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for EditingMode

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for EditingMode

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

Formats the value using the given formatter.

impl JsonSchema for EditingMode

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl PartialEq for EditingMode

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for EditingMode

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for EditingMode

impl Eq for EditingMode

impl StructuralPartialEq for EditingMode