Skip to content

CLI Environment and Flags

Mel edited this page Nov 10, 2026 · 1 revision

Environment variables

Every variable the CLI reads. It also sets GIT_TERMINAL_PROMPT=0 on the git processes it starts, and does not read that one.

Variable Read by Effect
ESCACS_STACK_ROOT stack remote ...; the background syncs that serve starts the stack checkout those commands read. Default: the checkout that contains the CLI
ESCACS_STACK_CACHE remote libraries the folder that holds the library clones and their <lib>.json records
XDG_CACHE_HOME remote libraries, when ESCACS_STACK_CACHE is unset cache root; the folder becomes $XDG_CACHE_HOME/escacs-stack/remotes
ESCACS_STACK_REMOTE_TTL_MS remote libraries milliseconds a synced cache is reused without contacting the remote. Default 15000. Values that are not a non-negative number are ignored
STACK_DEBUG remote libraries any non-empty value adds the raw git error (debug: line) to a note or warning
NO_COLOR output any non-empty value turns colour off
TERM output dumb turns colour off
HOME (through os.homedir()) stack link-skills the home folder for ~/.claude/skills and ~/.codex/skills

ESCACS_STACK is not read by the CLI.

Flags

Global flags are accepted anywhere on the line, so stack --json list works.

Flag Short Meaning
--json one JSON object on stdout (see stack help json)
--human aligned layout, coloured on a terminal
--plain plain text, even on a terminal
--full do not cut long summaries (human layout)
--offline never touch the network; use cached copies only
--verbose show raw git errors for remote libraries
--manifest show: include the raw stack.json (human layout)
--dry-run print the plan, write nothing. See the note in CLI Known Issues for init
--components [lib...] init: track remote libraries
--kind <kind> search: one kind
--project <dir> the project to act on (default: the current directory)
--to <dir> import: put one entry at this project path
--ref <rev> import, status, update, preset apply: another stack commit, tag or branch
--file <path> show: print one file of the entry
--port <n> serve: listen port; 0 picks a free one
--help -h help for a command, for example stack import --help
--version -V print the version
-- end flag parsing; everything after it is a word

--user is accepted and ignored: link-skills is always user-level now.

See also: CLI Output Modes, CLI Remote Libraries, CLI Maintainer Commands.

Clone this wiki locally