Skip to content

dotkit.env

Sits at the repo root. Sourced before any profile runs.

Any key set here is exported to all scripts in all profiles (via set -a). Put your own custom variables here, like DOTKIT_DEV_DIR for a shared dev folder path.

Terminal window
# dotkit.env
DOTKIT_DEV_DIR="~/dev"

Sits at the profile root (profiles/<name>/profile.env). Sourced after dotkit.env. Can override any variable.

profiles/work/profile.env
DOTKIT_DEV_DIR="~/work"
GITHUB_ORG=acme

Sits inside a run folder. Sourced before executing that folder’s files. Scoped to that folder only.

profiles/personal/git/run.env
MY_DEV_DIR=$DOTKIT_DEV_DIR
GITHUB_USER=yourname

Marks a folder as a link folder. Read by dotkit link.

KeyDescription
DESTDestination directory for symlinks. Absolute, ~/path, or relative to link.env.
profiles/personal/dotfiles/link.env
DEST=~

Marks a folder as a todo folder. Read by dotkit todo.

KeyDescription
DESTOutput directory or full .md path. Relative to todo.env.
NAMEOutput filename. Default: TODO.md.
TITLEH1 heading in the output. Default: folder name.
profiles/personal/manual/todo.env
DEST=..
NAME=MANUAL.md
TITLE=Setup Checklist