darn_cli 0.2.0

CLI for darn - CRDT-backed filesystem management
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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143

# darn

**D**irectory-based **A**utomerge **R**eplication **N**ode

CLI for darn - sync directories over CRDTs.

## Installation

```bash
cargo install --path .
```

Or from the workspace root:

```bash
cargo install --path darn_cli
```

## Commands

### Initialize a Workspace

```bash
darn init
```

Creates a `.darn/` directory in the current folder. On first run, also sets up your global signer key at `~/.config/darn/signer/`.

### Track Files

```bash
darn track myfile.txt
darn track src/*.rs
```

Converts files to Automerge documents and stores them in `.darn/storage/`.

### View Tracked Files

```bash
darn tree
```

Shows all tracked files with state indicators:

```
Workspace: /home/user/project

    src/main.rs
  M src/lib.rs
  ! deleted_file.txt

3 tracked: 1 clean, 1 modified, 1 missing
```

| Indicator | Meaning |
|-----------|---------|
| ` ` (space) | Clean - file matches stored version |
| `M` | Modified - file changed on disk |
| `!` | Missing - file deleted from disk |

### Stop Tracking

```bash
darn untrack myfile.txt
```

Removes from manifest but keeps the local file.

### Sync with Peers

```bash
# Sync with all peers
darn sync

# Sync with specific peer
darn sync --peer ws://192.168.1.50:8080
```

Automatically commits any local changes before syncing.

### Manage Peers

```bash
darn peer add ws://192.168.1.50:8080
darn peer list
darn peer remove ws://192.168.1.50:8080
```

### Watch for Changes

```bash
darn watch
```

_(Not yet implemented)_ Auto-sync when files change.

## Ignore Patterns

Create a `.darnignore` file (gitignore syntax):

```gitignore
.git/

# Build artifacts
target/
*.o

# Editor files
*.swp
*~

# Secrets
.env
*.key
```

The `.darn/` directory is always ignored.

## Environment Variables

| Variable   | Purpose                                     |
|------------|---------------------------------------------|
| `RUST_LOG` | Logging level (e.g., `RUST_LOG=debug`) |

## Storage Layout

```
.darn/
├── manifest.cbor       # Tracked file mappings
├── storage/
│   ├── blobs/          # Content-addressed blobs
│   └── trees/{id}/     # Per-document sedimentree
└── peers/              # Peer information (future)

~/.config/darn/
└── signer/
    └── private.key     # Ed25519 signing key
```

## License

Apache-2.0 OR MIT