# 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](https://kryptic.sh) suite.
> Status: **early development**. v0.0.1 is a scaffolding release — only
> `krypt --version` works today. The roadmap lives in
> [GitHub Issues](https://github.com/kryptic-sh/krypt/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:
```sh
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:
```sh
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)
```sh
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:
| `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
MIT. See [LICENSE](LICENSE).