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: pre-alpha. v0.0.2 ships the engine layers (schema parser, include expansion, path resolver, copy engine) as libraries. The CLI only exposes krypt version, krypt validate, and krypt paths so far — the user-facing surface (init / link / update / setup) lands in later Phase 1 milestones. See open issues for the plan.

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

cargo install krypt-cli            # any platform
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)

Every channel installs a binary named krypt on your $PATH.

The krypt crate name on crates.io is held by an unrelated 6-year-stale project — we publish the bin as krypt-cli for now. If/when the name transfers (see #37), cargo install krypt will become the canonical install command.

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:

License

MIT. See LICENSE.