Keep using Photos.app like you always do. Attic quietly backs up your originals and edits to an S3 bucket you control. One-way, append-only.
docs: add viewer command to README and CLAUDE.md
+18
+1
CLAUDE.md
+1
CLAUDE.md
···
63
63
| `verify` | Verify S3 objects against manifest |
64
64
| `refresh-metadata` | Re-upload metadata JSON |
65
65
| `rebuild` | Rebuild manifest from S3 metadata |
66
+
| `viewer` | Browse backed-up library in local web UI |
66
67
| `init` | Interactive S3 setup |
67
68
68
69
## Testing Patterns
+17
README.md
+17
README.md
···
144
144
attic rebuild
145
145
```
146
146
147
+
### viewer
148
+
149
+
Browse your backed-up library in a local web UI. Starts a localhost HTTP server
150
+
that loads metadata from S3 and serves a photo grid with filtering and lightbox.
151
+
152
+
```bash
153
+
attic viewer
154
+
```
155
+
156
+
| Flag | Description |
157
+
| ---------- | ---------------------------------- |
158
+
| `--port N` | HTTP port (default: random unused) |
159
+
160
+
The viewer loads metadata progressively in the background — you can start
161
+
browsing immediately while the full library loads. Filters (year, album,
162
+
favorites, photo/video) update dynamically as metadata arrives.
163
+
147
164
## Configuration
148
165
149
166
Attic stores its configuration at `~/.attic/config.json`: