Global CLI Reference

The explita unified binary acts as the root command-line interface for the entire Explita infrastructure suite. It provides shared commands for global configuration, shell completion, and versioning, while routing product subcommands to dedicated subsystem engines.

explita [command] [options]

1. Subsystem Binaries & AliasesCopy Anchor Link

Explita provides both the unified explita dispatcher and lightweight, dedicated binaries for each product:

Both invocations share the same runtime configuration, authentication context, and flags.

2. Global FlagsCopy Anchor Link

These flags can be passed to the root explita command or any product binary:

explita --version
explita --help

3. Unified Configuration (explita config)Copy Anchor Link

Manage global configurations shared across all Explita products. Global configuration is stored in ~/.explita/config.json.

explita config [subcommand]

SubcommandsCopy Anchor Link

# List all active unified configuration across products
explita config
explita config ls

# Retrieve a specific configuration key
explita config get <key>

# Update a configuration value
explita config set <key> <value>

# Print the filesystem path to the global configuration file
explita config path

Configuration NamespacesCopy Anchor Link

Settings are namespaced by product:

ExamplesCopy Anchor Link

# Set default Deploy server endpoint
explita config set deploy.server https://deploy.myteam.internal

# Set global Deploy authentication token
explita config set deploy.token secret-deploy-token-12345

# Set custom self-hosted Tunnel gateway endpoint
explita config set tunnel.server wss://tunnel.myteam.internal/_connect

# View the full unified configuration
explita config ls

[!NOTE] Zero-Disk Passcode Security: Secondary security passcodes and PINs (DEPLOY_PASSCODE) are never stored in configuration files. They are known strictly to the operator in memory and entered interactively (🔑 Enter deploy passcode / PIN:) or supplied per-command via --pass <pin>.

4. Shell Autocompletion (explita completion)Copy Anchor Link

Generate fast tab-completion scripts for your active shell, supporting subcommands, dynamic options, and flags.

explita completion [bash|zsh|fish|powershell]

Zsh SetupCopy Anchor Link

# Append to ~/.zshrc
explita completion zsh >> ~/.zshrc
source ~/.zshrc

Bash SetupCopy Anchor Link

# Append to ~/.bashrc (requires bash-completion)
explita completion bash >> ~/.bashrc
source ~/.bashrc

Fish SetupCopy Anchor Link

# Save to fish completions directory
explita completion fish > ~/.config/fish/completions/explita.fish

PowerShell (Windows)Copy Anchor Link

# Append to PowerShell Profile ($PROFILE)
explita completion powershell | Out-String | Invoke-Expression

5. Product-Specific CLI ReferencesCopy Anchor Link

For detailed subcommands, options, and parameters specific to individual products, visit their dedicated references: