.dev-cli-flags.toml

# Dedicated flags-2-env contract for the modular `zed develop` / `zed dev`
# command. Runtime help and completions augment the established Clap command
# with the same typed DevelopArgs definition used here.

[env]
dotenv = false
files = []
ignore = ["ZED_PKG_TOKEN"]

[parse]
command_env = "ZED_PKG_COMMAND"
unknown_options_env = "ZED_PKG_UNKNOWN_OPTIONS"
errors_env = "ZED_PKG_PARSE_ERRORS"
allow_unknown = false

[help]
url = "https://github.com/zed-pkg/zed-cli/blob/main/docs/develop.md"

[flags.registry]
env = "ZED_PKG_REGISTRY"
aliases = ["registry"]
type = "string"
default = "https://registry.zpkg.net"
help = "Registry base URL."

[flags.home]
env = "ZED_PKG_HOME"
aliases = ["home"]
type = "string"
help = "Zed home directory; defaults to ~/.zed-pkg."

[flags.auth_url]
env = "ZED_PKG_AUTH_URL"
aliases = ["auth-url"]
type = "string"
help = "shared-auth base URL."

[flags.supabase_url]
env = "ZED_PKG_SUPABASE_URL"
aliases = ["supabase-url"]
type = "string"
help = "Supabase project URL."

[flags.supabase_key]
env = "ZED_PKG_SUPABASE_KEY"
aliases = ["supabase-key"]
type = "string"
help = "Supabase publishable/anon key."

[flags.interactive]
env = "ZED_PKG_INTERACTIVE"
aliases = ["interactive"]
type = "bool"
default = "false"
help = "Confirm each mutating lifecycle step in a real terminal."

[flags.local_path_map]
env = "ZED_PKG_LOCAL_REGISTRY_PATH_MAP"
aliases = ["local-path-map"]
type = "string"
help = "host=container path rewrites for local registry entries, comma separated."

[flags.local_link_policy]
env = "ZED_PKG_LOCAL_LINK_POLICY"
aliases = ["local-link-policy"]
type = "string"
help = "How a local checkout reaches zed_modules/: auto, symlink, or copy."

[flags.local_ephemeral]
env = "ZED_PKG_LOCAL_REGISTRY_EPHEMERAL"
aliases = ["local-ephemeral"]
type = "bool"
default = "false"
help = "Copy every local checkout because its media will not outlive this process."

[flags.git_submodules]
env = "ZED_PKG_GIT_SUBMODULES"
aliases = ["git-submodules"]
type = "bool"
default = "false"
help = "Global Git submodule compatibility mode for install and overtake."

[flags.no_mirrors]
env = "ZED_PKG_NO_MIRRORS"
aliases = ["no-mirrors"]
type = "bool"
default = "false"
help = "Disable mirror fallback."

[flags.trust_mirror_metadata]
env = "ZED_PKG_TRUST_MIRROR_METADATA"
aliases = ["trust-mirror-metadata"]
type = "bool"
default = "false"
help = "Allow signed mirror metadata to answer resolution requests."

[flags.r2_public_base]
env = "ZED_PKG_R2_PUBLIC_BASE"
aliases = ["r2-public-base"]
type = "string"
help = "Public HTTPS origin for R2/CDN objects."

[flags.r2_public_key]
env = "ZED_PKG_R2_PUBLIC_KEY"
aliases = ["r2-public-key"]
type = "string"
help = "Public R2 hostname, URL, or account subdomain."

[flags.source_fallback]
env = "ZED_PKG_SOURCE_FALLBACK"
aliases = ["source-fallback"]
type = "bool"
default = "true"
help = "Retry public R2 and GitHub when an HTTP registry is unreachable."

[commands.develop]
aliases = ["dev"]
help = "Enter a package-aware, cross-language virtual development environment."

[commands.develop.flags.command]
env = "ZED_DEV_COMMAND"
aliases = ["command"]
short = "c"
type = "string"
help = "Run one command through the selected shell."

[commands.develop.flags.shell]
env = "ZED_DEV_SHELL"
aliases = ["shell"]
type = "string"
help = "Shell executable."

[commands.develop.flags.nix]
env = "ZED_DEV_NIX"
aliases = ["nix"]
type = "string"
default = "auto"
help = "Nix composition mode: auto, never, or required."

[commands.develop.flags.mise]
env = "ZED_DEV_MISE"
aliases = ["mise"]
type = "string"
default = "auto"
help = "mise composition mode: auto, never, or required."

[commands.develop.flags.profile]
env = "ZED_DEV_PROFILE"
aliases = ["profile"]
type = "string"
default = "default"
help = "Development profile: default or ai."

[commands.develop.flags.no_install]
env = "ZED_DEV_NO_INSTALL"
aliases = ["no-install"]
type = "bool"
default = "false"
help = "Skip package restoration."

[commands.develop.flags.frozen]
env = "ZED_PKG_FROZEN"
aliases = ["frozen"]
type = "bool"
default = "false"
help = "Require manifest-backed installs to match the lockfile."

[commands.develop.flags.allow_build]
env = "ZED_PKG_ALLOW_BUILD"
aliases = ["allow-build"]
type = "bool"
default = "false"
help = "Allow dependency build hooks."

[commands.develop.flags.allow_native_deps]
env = "ZED_PKG_ALLOW_NATIVE_DEPS"
aliases = ["allow-native-deps"]
type = "bool"
default = "false"
help = "Allow zed to install host-native prerequisites declared by packages."

[commands.develop.flags.allow_install_hooks]
env = "ZED_PKG_ALLOW_INSTALL_HOOKS"
aliases = ["allow-install-hooks"]
type = "bool"
default = "false"
help = "Allow package-authored pre-install and post-install hooks."

[commands.develop.flags.native_manager]
env = "ZED_PKG_NATIVE_MANAGER"
aliases = ["native-manager"]
type = "string"
help = "Pin the graph-wide native package manager."

[commands.develop.flags.isolated_home]
env = "ZED_DEV_ISOLATED_HOME"
aliases = ["isolated-home"]
type = "bool"
default = "false"
help = "Redirect HOME and XDG config/data into .zed/dev."

[commands.develop.flags.print_env]
env = "ZED_DEV_PRINT_ENV"
aliases = ["print-env"]
type = "bool"
default = "false"
help = "Print the managed environment as JSON."

[commands.develop.flags.python_venv]
env = "ZED_DEV_PYTHON_VENV"
aliases = ["python-venv"]
type = "string"
default = "auto"
help = "Python venv mode: auto, never, or required."

[commands.develop.flags.python]
env = "ZED_DEV_PYTHON"
aliases = ["python"]
type = "string"
help = "Python interpreter used to create a venv."

[commands.develop.flags.venv]
env = "ZED_DEV_VENV"
aliases = ["venv"]
type = "string"
default = ".zed/dev/python/venv"
help = "Managed virtual-environment path."