Environment Variables¶

Environment variables that affect Stack's behavior.

Authentication¶

GITHUB_TOKEN¶

GitHub personal access token or OAuth token.

export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx

Takes precedence over stored credentials.

GITLAB_TOKEN¶

GitLab personal access token.

export GITLAB_TOKEN=glpat-xxxxxxxxxxxxxxxxxxxx

Takes precedence over stored credentials.

Debugging¶

RUST_LOG¶

Control log verbosity.

# Enable debug logging
export RUST_LOG=debug

# Enable trace logging (very verbose)
export RUST_LOG=trace

# Filter by module
export RUST_LOG=stack_core=debug,stack_github=trace

RUST_BACKTRACE¶

Show backtraces on errors.

export RUST_BACKTRACE=1

Git Configuration¶

Stack respects standard Git environment variables:

GIT_DIR¶

Override the Git directory location.

export GIT_DIR=/path/to/.git

GIT_WORK_TREE¶

Override the working tree location.

export GIT_WORK_TREE=/path/to/worktree

GIT_AUTHOR_NAME / GIT_AUTHOR_EMAIL¶

Override commit author information.

export GIT_AUTHOR_NAME="Your Name"
export GIT_AUTHOR_EMAIL="[email protected]"

Editor¶

EDITOR / VISUAL¶

Editor for commit messages and interactive operations.

export EDITOR=vim
# or
export VISUAL="code --wait"

Example: CI Environment¶

For CI/CD pipelines:

# .github/workflows/ci.yml
env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
  RUST_LOG: info

Example: Development¶

For local development:

# ~/.bashrc or ~/.zshrc
export GITHUB_TOKEN=ghp_your_token
export RUST_LOG=debug
export EDITOR=nvim

Precedence¶

For authentication, precedence is:

Environment variables (highest)
Stored credentials (~/.config/stack/credentials.json)
Git credential helpers (lowest)