yui-cli 0.1.0

Target-as-truth dotfiles manager: edit your live configs, source repo updates automatically via hardlink/junction/symlink.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

# yui

> 結 — *target-as-truth* dotfiles manager

`yui` is a dotfiles manager that flips the chezmoi flow on its head: edit
your live configs (the **target**), and the source repo updates
automatically. Built to fix three chezmoi pain points:

- having to edit the source first and `apply` afterwards is a constant tax
- apps overwrite the target directly, so source and target drift
- new files apps create aren't tracked, and you can't even notice them

## How it works

The actual files live in your dotfiles repo, and the targets are
**hardlinks / junctions / symlinks** pointing at them. When an app writes
to the target, the link routes the write straight through to source — no
copy step, no drift.

| Platform | files | directories |
|----------|-------|-------------|
| Linux / macOS | symlink | symlink |
| Windows (default) | hardlink | junction |
| Windows (opt-in) | symlink | symlink (requires Developer Mode / admin) |

Drop a `.yuilink` marker file inside any directory in your source tree
to make `yui` link that whole directory as a single unit — files an
app creates inside it land directly in your source repo.

When an editor's atomic-save breaks a hardlink, `yui` looks at mtimes,
content, and git status to decide between **auto-absorb** (target →
source, with backup), **relink only** (contents identical), or **ask**
(anomaly).

## Install

```sh
cargo install yui-cli
```

Binary lives at `~/.cargo/bin/yui`. Make sure that's on your `PATH`.

## Quick start

```sh
# Initialize a fresh source repo at $DOTFILES (and install git hooks).
yui init --git-hooks

# Edit $DOTFILES/config.toml to declare your mounts, then:
yui apply        # render templates + link targets + auto-absorb drift
yui status       # show drift across all mounts
yui doctor       # diagnose your environment
```

Minimal `$DOTFILES/config.toml`:

```toml
[vars]
git_email = "you@example.com"

[[mount.entry]]
src = "home"
dst = "{{ env(name='HOME') | default(value=env(name='USERPROFILE')) }}"

[[mount.entry]]
src  = "appdata"
dst  = "{{ env(name='APPDATA') }}"
when = "{{ yui.os == 'windows' }}"
```

`config.local.toml` (gitignored) is for machine-local overrides:

```toml
[vars]
git_email = "you@work.example"
```

Built-in variables exposed to Tera: `yui.os`, `yui.host`, `yui.user`,
`yui.arch`, `yui.source`. Environment variables are read with
`{{ env(name='HOME') }}` (Tera's standard function).

## Status

Pre-release. MVP design complete; implementation in progress.

## License

MIT