krypt

Cross-platform dotfiles manager. Rust binary. Config-driven.

A vault for your dotfiles — clone, deploy, and keep in sync across Linux, macOS, and Windows. Part of the kryptic.sh suite.

Status: early development. v0.0.1 is a scaffolding release — only krypt --version works today. The roadmap lives in GitHub Issues organized into phase milestones.

What it will do

One binary to manage your dotfiles end-to-end on Linux, macOS, and Windows.
Replaces stow (copy-based deploy with manifest-tracked drift detection).
Replaces ad-hoc bash scripts via a declarative .krypt.toml and a step runner.
Interactive first-run wizard that fills in user-specific values.
Cross-distro / cross-platform package install abstraction.

Install

Not yet released for general use. Once v0.1+ ships:

paru -S krypt-bin                  # Arch (AUR)
brew install kryptic-sh/tap/krypt  # macOS
scoop install krypt                # Windows (planned)
nix run github:kryptic-sh/krypt    # Nix (planned)

Build from source any platform:

cargo install --git https://github.com/kryptic-sh/krypt

The krypt name on crates.io is currently held by an unrelated stale 2020 project — cargo install krypt does not yet point at this tool. A transfer request is in flight; until resolved, prefer the package managers above or the --git install.

Quickstart (planned API)

krypt init https://github.com/you/dotfiles   # clone repo to XDG path
krypt setup                                  # interactive wizard
krypt link                                   # deploy
krypt update                                 # daily-driver: pull + redeploy
krypt doctor                                 # diagnostic

Architecture

Four-crate Cargo workspace:

Crate	Role
`krypt-cli`	Binary (`krypt`) — clap dispatch, thin
`krypt-core`	Engine: config parser, path resolver, copy engine, manifest, runner
`krypt-pkg`	Package manager abstraction (pacman, apt, brew, scoop, winget, dnf)
`krypt-platform`	OS-specific abstractions (cfg-gated)

License