CLI Reference

The cuenv CLI provides tools for managing environments, executing tasks, and integrating with your shell.

Global Options

Option	Description	Default
--level, -l	Set logging level (trace, debug, info, warn, error)	warn
--json	Emit JSON envelope regardless of format	false

Commands

cuenv version

Show version information.

cuenv version [OPTIONS]

Options:

• --output-format <FORMAT>: Output format (simple, json, env). Default: simple.

cuenv env

Environment variable operations.

cuenv env print

Print environment variables from CUE package.

cuenv env print [OPTIONS]

Options:

• -p, --path <PATH>: Path to directory containing CUE files. Default: .
• --package <PACKAGE>: Name of the CUE package to evaluate. Default: cuenv
• --output-format <FORMAT>: Output format (env, json, simple). Default: env

cuenv env load

Load environment and execute hooks in background.

cuenv env load [OPTIONS]

Options:

• -p, --path <PATH>: Path to directory containing CUE files. Default: .
• --package <PACKAGE>: Name of the CUE package to evaluate. Default: cuenv

cuenv env check

Check hook status and output environment for shell.

cuenv env check [OPTIONS]

Options:

• -p, --path <PATH>: Path to directory containing CUE files. Default: .
• --package <PACKAGE>: Name of the CUE package to evaluate. Default: cuenv
• --shell <SHELL>: Shell type for export format (bash, zsh, fish). Default: bash

cuenv task

Execute a task defined in CUE configuration.

cuenv task [NAME] [OPTIONS]

Arguments:

• [NAME]: Name of the task to execute. If not provided, lists available tasks.

Options:

• -p, --path <PATH>: Path to directory containing CUE files. Default: .
• --package <PACKAGE>: Name of the CUE package to evaluate. Default: cuenv
• -e, --env <ENVIRONMENT>: Apply environment-specific overrides (e.g., development, production).
• --materialize-outputs <DIR>: Materialize cached outputs to this directory on cache hit.
• --show-cache-path: Print the cache path for this task key.

cuenv exec

Execute a command with CUE environment variables.

cuenv exec [OPTIONS] -- <COMMAND> [ARGS]...

Options:

• -p, --path <PATH>: Path to directory containing CUE files. Default: .
• --package <PACKAGE>: Name of the CUE package to evaluate. Default: cuenv
• -e, --env <ENVIRONMENT>: Apply environment-specific overrides.

cuenv shell

Shell integration commands.

cuenv shell init

Generate shell integration script.

cuenv shell init <SHELL>

Arguments:

• <SHELL>: Shell type (fish, bash, zsh).

cuenv env status

Show hook execution status.

cuenv env status [OPTIONS]

Options:

• -p, --path <PATH>: Path to directory containing CUE files. Default: .
• --package <PACKAGE>: Name of the CUE package to evaluate. Default: cuenv
• --wait: Wait for hooks to complete before returning.
• --timeout <SECONDS>: Timeout in seconds for waiting. Default: 300
• --output-format <FORMAT>: Output format (text, short, starship). Default: text

cuenv env inspect

Inspect cached hook state for the current config.

cuenv env inspect [OPTIONS]

Options:

• -p, --path <PATH>: Path to directory containing CUE files. Default: .
• --package <PACKAGE>: Name of the CUE package to evaluate. Default: cuenv

cuenv ci

Run CI pipelines defined in your CUE configuration.

cuenv ci [OPTIONS]

Options:

• --dry-run: Show what would be executed without running it.
• --pipeline <NAME>: Force a specific pipeline to run.
• --generate <PROVIDER>: Generate CI workflow file (currently only github is supported).

Example:

# Run CI pipeline
cuenv ci

# See what would run without executing
cuenv ci --dry-run

# Generate GitHub Actions workflow
cuenv ci --generate github

Security Commands

cuenv allow

Approve configuration for hook execution.

cuenv allow [OPTIONS]

Options:

• -p, --path <PATH>: Path to directory containing CUE files. Default: .
• --package <PACKAGE>: Name of the CUE package to evaluate. Default: cuenv
• --note <NOTE>: Optional note about this approval.
• -y, --yes: Approve without prompting.

cuenv deny

Revoke approval for hook execution.

cuenv deny [OPTIONS]

Options:

• -p, --path <PATH>: Path to directory containing CUE files. Default: .
• --package <PACKAGE>: Name of the CUE package to evaluate. Default: cuenv
• --all: Revoke all approvals for this directory.