Environment Variables - Shux

The following environment variables are available in all agent bash tool executions, including init hooks.

Available Variables

Variable	Description
`SHUX_PROJECT_PATH`	Absolute path to the project root on the local machine. Always refers to your local project path, even on SSH workspaces.
`SHUX_RUNTIME`	Runtime type: `"local"`, `"worktree"`, `"ssh"`, or `"docker"`
`SHUX_WORKSPACE_NAME`	Name of the workspace (typically the branch name)
`SHUX_MODEL_STRING`	Model identifier (e.g., `"anthropic:claude-sonnet-4-20250514"`)
`SHUX_THINKING_LEVEL`	Reasoning level: `"off"`, `"low"`, `"medium"`, `"high"`, or `"xhigh"`
`SHUX_COSTS_USD`	Cumulative session costs in USD, formatted to 2 decimal places (e.g., `"1.23"`)

Matching MUX_* names remain accepted aliases. When both are set, the SHUX_* value wins. See Mux compatibility.

Usage Example

#!/usr/bin/env bash

echo "Project: $SHUX_PROJECT_PATH"
echo "Runtime: $SHUX_RUNTIME"
echo "Workspace: $SHUX_WORKSPACE_NAME"
echo "Model: $SHUX_MODEL_STRING"
echo "Thinking: $SHUX_THINKING_LEVEL"
echo "Costs: \$${SHUX_COSTS_USD:-0.00}"

# Runtime-specific behavior
if [ "$SHUX_RUNTIME" = "ssh" ]; then
  echo "Running on SSH remote"
elif [ "$SHUX_RUNTIME" = "docker" ]; then
  echo "Running in Docker container"
else
  echo "Running locally"
fi

Use Cases

PR footers: Include model and cost information in automated PR descriptions
Conditional logic: Adapt scripts based on runtime environment
Logging: Track which model and settings were used for a task
Cost monitoring: Check cumulative costs before expensive operations

⌘I