dek

pronounced "deynek"

Declarative environment setup. One TOML, any machine.

Install

cargo install dek
# or
curl cagdas.io/dek | sh

# setup completions
dek setup

Usage

dek apply              # apply ./dek.toml or ./dek/
dek apply setup.toml
dek check              # dry-run, show what would change
dek plan               # list items from config (no state check)

Config

# Packages
[package.os]  # auto-detects: pacman, apt, dnf, brew
items = ["curl", "git", "htop"]

[package.cargo]  # auto-installs cargo/go/npm/pip if missing
items = ["bat", "eza", "ripgrep"]

[package.go]
items = ["github.com/junegunn/fzf@latest"]

[package.npm]
items = ["prettier", "typescript"]

[package.pip]
items = ["httpie", "tldr"]

# Systemd services
[[service]]
name = "docker"
state = "active"
enabled = true

# Files
[file.copy]
"dotfiles/.zshrc" = "~/.zshrc"

[file.symlink]
"~/dotfiles/nvim" = "~/.config/nvim"

[file.ensure_line]
"~/.bashrc" = [
    "export PATH=$HOME/.local/bin:$PATH",
    "source ~/.aliases"
]

# Shell (auto-sources in your rc file)
[alias]
la = "ls -larth"
lg = "lazygit"

[env]
EDITOR = "nvim"

Split Config

dek/
├── 00-packages.toml
├── 10-services.toml
├── 20-dotfiles.toml
└── 30-shell.toml

Files are merged alphabetically.

Test

Spin up a container, apply config, drop into shell:

dek test                    # archlinux by default
dek test --image ubuntu
dek test --keep             # don't destroy after exit

Builds dek locally and mounts into container - no compilation inside the container.

Inline

Quick one-off installs without a config file:

dek os.htop os.git cargo.bat
dek pip.httpie npm.prettier

Format: provider.package where provider is os, apt, pacman, cargo, go, npm, or pip.

os auto-detects your system package manager (pacman, apt, dnf, brew).

Remote (planned)

dek --target user@host apply
dek --target user@host cargo.bat

Bake

Embed config into a standalone binary:

dek bake dek.toml -o mysetup      # from file
dek bake dek/ -o mysetup          # from directory
./mysetup                          # applies config (default)
./mysetup check                    # dry-run
./mysetup info                     # show bake info

Package:Binary Syntax

When package names differ from the binary they install, use package:binary syntax:

[package.cargo]
items = ["bat", "ripgrep:rg", "fd-find:fd", "bottom:btm"]

[package.webi]
items = ["jq", "ripgrep:rg", "fzf"]

[package.go]
items = ["github.com/junegunn/fzf@latest"]  # auto-derives "fzf" from path

This tells dek to:

1. Install the package part
2. Check if the binary part exists in PATH

Without :binary, dek assumes the binary name matches the package name (or derives it from go paths).