Repository navigation
CLI Environment and Flags
Mel edited this page Nov 10, 2026
·
1 revision
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.
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.
Stack desktop client + CLI wiki — condensed from the repo docs. App repo: https://github.com/escacs/stack-app. CLI repo (private): https://github.com/escacs/stack.