Enum Commands 

pub enum Commands {
    Sessions,
    Tree {
        session_id: String,
    },
    Fork {
        parent_id: String,
        entry_id: String,
    },
    Delete {
        session_id: String,
    },
    Issue {
        action: IssueCommands,
    },
    Pkg {
        action: PkgCommands,
    },
    Config {
        action: ConfigCommands,
    },
    Ext {
        action: ExtCommands,
    },
    Models {
        provider: Option<String>,
    },
    Refresh {},
    Setup {
        reset: bool,
    },
    Reset {
        yes: bool,
        include_project: bool,
    },
    Export {
        session_id: Option<String>,
        output: Option<PathBuf>,
    },
    Import {
        path: PathBuf,
    },
    Share {
        session_id: Option<String>,
    },
    Completions {
        shell: String,
    },
    Install {
        source: String,
    },
    Update {
        check: bool,
    },
    Commit {
        push: bool,
        dry_run: bool,
        context: Option<String>,
    },
}

CLI subcommands

Variants

Sessions

List all sessions for this project

Tree

Show session entry tree structure

Fields

session_id: String

Session ID or prefix (default: current/last session for this project)

Fork

Fork a new session from a specific entry

Fields

parent_id: String

Parent session ID or prefix

entry_id: String

Entry ID to branch from

Delete

Delete a session by ID (prefix match supported)

Fields

session_id: String

Session ID or prefix (from oxicode sessions)

Issue

Local issue management

Fields

action: IssueCommands

Action

Pkg

Package management

Fields

action: PkgCommands

action.

Config

Configuration management

Fields

action: ConfigCommands

action.

Ext

Extension management — install, update, remove WASM extensions

Fields

action: ExtCommands

action.

Models

List available models

Fields

provider: Option<String>

Filter by provider name (e.g., openai, anthropic, minimax)

Refresh

Refresh the model catalog from models.dev

Performs a conditional GET (ETag). Updates take effect on next start.

Setup

Run the interactive setup wizard

Fields

reset: bool

Reset all settings to defaults

Reset

Reset all settings and data to factory defaults

Use when configuration has become tangled and you want a clean start. An interactive confirmation prompt will be shown.

Fields

yes: bool

Skip the confirmation prompt

include_project: bool

Also delete the project-local .oxicode/ directory

Export

Export a session to HTML

Fields

session_id: Option<String>

Session ID or prefix (default: most recent for this project)

output: Option<PathBuf>

Output file path (default: oxicode-export-{id}.html in CWD)

Import

Import a session from a JSONL file

Fields

path: PathBuf

Path to the JSONL session file

Share

Share a session as a GitHub Gist (requires gh CLI)

Fields

session_id: Option<String>

Session ID or prefix (default: most recent for this project)

Completions

Generate shell completion scripts (bash, zsh, or fish)

Fields

shell: String

Shell type: bash, zsh, or fish

Install

Install an extension package (alias for ext install/pkg install)

Fields

source: String

Package source: a local directory path or npm:@scope/name

Update

Update oxicode to the latest version

Fields

check: bool

Check for updates without installing

Commit

Generate a commit message and commit staged changes

Fields

push: bool

Push after committing

dry_run: bool

Preview without committing

context: Option<String>

Additional context for the model

Trait Implementations

impl Clone for Commands

fn clone(&self) -> Commands

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Commands

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

Formats the value using the given formatter.

impl FromArgMatches for Commands

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for Commands

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand