deez-dots

Deez dots is a CLI tool for managing dotfiles and dotfile deployments. Sooner this will be the backend implementation for The HyDE Project.

Example Usage

./deez --version
./deez --help
./deez dots --config ./example/dots.toml --deploy
./deez deps --config ./example/dots.toml --check
./deez cache --list

You can also run via Python directly from the repo root:

python -m deez --version
python -m deez dots --config ./example/dots.toml --deploy

Or install directly from GitHub without using a curl-to-shell bootstrap:

With pip:

python -m pip install git+https://github.com/HyDE-Project/deez-dots.git

With pipx:

pipx install git+https://github.com/HyDE-Project/deez-dots.git

With uv as a persistent tool install:

uv tool install git+https://github.com/HyDE-Project/deez-dots.git

With uv as a one-off run:

uv tool run --from git+https://github.com/HyDE-Project/deez-dots.git deez --version

Then run it as:

deez --version
deez dots --config ./example/dots.toml --deploy

PEX Release

You can build a single-file executable using pex:

python3 -m pip install pex
python3 -m pex . -e deez_dots:run_entrypoint -o target/deez.pex

Run the generated release file directly:

./target/deez.pex --version

Man Page

Generate the complete single-page manual with:

make man

This uses scdoc to create build/deez.1 in a single Arch-style manpage format.

Typical usage:

deez --version
./deez --help
./deez dots --help
./deez deps --help