Environment variables
Every environment variable zeropty reads.
Environment variables
| Variable | Default | Meaning |
|---|---|---|
ZEROPTY_SOCK | ~/.zeropty/mux.sock | Server socket (path of 103 bytes or less) |
ZEROPTY_HISTORY | 500 | Number of scrollback lines |
ZEROPTY_COALESCE_MS | 300 | Interval for batching output reads. Once 16KB or more has piled up it is read immediately, and screen reads always process pending output first. Attached terminals get output right away |
ZEROPTY_FREEZE_MS | 250 | After this much quiet, the whole screen is frozen |
ZEROPTY_COLD | file | Where compressed copies of long-quiet screens are kept. memory keeps them in process memory |
ZEROPTY_COLD_DIR | temp directory | Directory where the compressed-copy file is created (its name is unlinked right after creation) |
ZEROPTY_RECORD | – | Directory to record session output into as <name>.raw/.trace |
ZEROPTY_PURGE_MS | 0 | Standalone server: how long to wait before returning freed memory to the OS |
ZEROPTY_BIN | dist/zeropty | Program run by the Node client, the zsh function and the bash builtin |
ZEROPTY_NODE | dist/zeropty.node | Native module loaded by the Node client |
ZEROPTY_SHIM | dist/shim.dylib | Shim injected by zeropty-tty |
ZEROPTY_CACHE | ~/.zeropty | Where zeropty-tty keeps re-signed copies (under tty/) |
ZEROPTY_CLAUDE_REAL | claude on PATH | The claude that claude-zeropty launches |
ZEROPTY_PLUGIN_DIR | (unset: off) | Plugin directory the server launches. Only when set are the executables and .dylib files in it run. A server started by restart-server or new-session takes the value from the shell that ran that command (PLUGINS.md) |
ZEROPTY_PLUGIN_TIMEOUT_MS | 10000 | Deadline for plugin commands and hooks. A plugin's Host::command waits up to half of it |