Enum Command 

pub enum Command {
    Run(RunArgs),
    Attach {
        session: Option<SessionId>,
    },
    Resume {
        session: Option<SessionId>,
    },
    Serve {
        session: SessionId,
        create: bool,
        existing: bool,
        create_or_existing: bool,
        bootstrap_prompt_file: Option<PathBuf>,
        bootstrap_id: Option<BootstrapId>,
        mirror_extension_stderr: bool,
    },
    Session {
        command: SessionCommand,
    },
    Agent {
        command: AgentCommand,
    },
    Init {
        force: bool,
    },
    Provider {
        args: Vec<String>,
    },
    Dev {
        command: DevCommand,
    },
    Component {
        name: String,
        initial_ui_stdio: bool,
    },
}

Variants

Run(RunArgs)

Run an interactive agent session.

tau spawns a new harness daemon and attaches for this process.

Attach

Attach to a running session without taking daemon ownership.

Fields

session: Option<SessionId>

Running session id; omit to choose interactively.

Resume

Resume a persisted session in a new harness daemon.

Fields

session: Option<SessionId>

Persisted session id; omission auto-selects the sole unlocked target, otherwise shows the eligible-session picker.

Serve

Serve one fixed session in the foreground without an initial UI.

Fields

session: SessionId

Exact session id to create or resume.

create: bool

Require the session directory to be completely absent, then create it.

existing: bool

Require and strictly resume valid existing session state.

create_or_existing: bool

Resume valid existing state or atomically create an absent session.

bootstrap_prompt_file: Option<PathBuf>

Read one literal bootstrap prompt from this UTF-8 file after startup.

- reads stdin through EOF once. The paired bootstrap id makes this submission durable and at-most-once across restarts.

bootstrap_id: Option<BootstrapId>

Durable bootstrap generation id.

mirror_extension_stderr: bool

Mirror framed, escaped extension stderr to this process’s stderr.

Private per-session extension log files remain authoritative. Custom extension stderr is unredacted and may reach a wider journal audience.

Session

Inspect sessions.

Fields

command: SessionCommand

Agent

Inspect agents.

Fields

command: AgentCommand

Init

Copy sample config files to ~/.config/tau/

Fields

force: bool

Overwrite existing config files

Provider

Manage LLM providers (add, remove, list)

Fields

args: Vec<String>

Subcommand and arguments (e.g. add, remove <name>, list)

Dev

Developer-only commands.

Fields

command: DevCommand

Component

Run a bundled Tau component as a standalone process.

Bundled extensions are components too, but not every component is an extension; for example, the harness is a component.

Fields

name: String

Component name (harness or a bundled extension such as ext-shell, ext-provider-builtin, ext-websearch, ext-rhai, ext-std-notifications, or ext-test-dummy)

initial_ui_stdio: bool

Use stdin/stdout as the initial UI connection before starting harness extensions. Only valid with tau component harness.

Trait Implementations

impl FromArgMatches for Command

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 Command

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