Skip to main content
Documentation
Configuration

Environment Variables

The current CLI reads author identity variables; it does not implement general environment-based configuration overrides.

Commit identity

ValueLookup order
Commit author nameDITS_AUTHOR_NAME → GIT_AUTHOR_NAME → USER → Unknown
Commit author emailDITS_AUTHOR_EMAIL → GIT_AUTHOR_EMAIL → <name>@localhost
export DITS_AUTHOR_NAME="CI Bot"
export DITS_AUTHOR_EMAIL="ci@example.com"

dits add output.mov
dits commit -m "Record generated output"

DITS_AUTHOR_DATE and DITS_COMMITTER_* are not read. A commit currently uses the same resolved identity for author and committer and records the current time.

Lock owner lookup

Advisory lock commands first ask Git for user.email, then fall back to USER or USERNAME. This lookup is separate from Dits TOML configuration.

Hook context supplied by Dits

When Dits starts a hook process, it supplies:

VariableMeaning
DITS_DIRThe current repository's .dits directory
DITS_HOOKThe hook filename being executed

These are output context for hook subprocesses. Setting DITS_DIRbefore invoking Dits does not redirect repository discovery.

Not implemented

The current alpha does not read DITS_WORK_TREE, DITS_CACHE_DIR, DITS_CONFIG_GLOBAL, DITS_CONFIG_SYSTEM, DITS_EDITOR, DITS_PAGER, DITS_SSH_COMMAND, DITS_TRACE*, DITS_DEBUG, DITS_TOKEN, or DITS_SERVER. Support for those names is design work unless and until it is implemented and tested.

Related topics