CLAUDE.md


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

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## What This Is

Single-script dotfile backup tool. `dot-backup.sh` copies files from `DOTFILES` array to a local git repo (`~/Programming/GIT/my-dotfiles`), split into `home/` and `system/` subdirectories, then stages everything with `git add`.

## Running

```bash
./dot-backup.sh
```

No build step. No tests. No deps beyond bash + rsync + git.

## Architecture

`dot-backup.sh` does three things in sequence:

1. **Setup** — ensures `$DEFAULT_OUTPUT_DIR` exists with `home/` and `system/` subdirs; initializes git if needed; writes `lastupdate` timestamp
2. **Copy loop** — iterates `DOTFILES` array; paths starting with `/` go to `system/`, all others go to `home/`; uses `rsync -a` for both files and directories
3. **Commit** — `git add .` + auto-commits with timestamp message in `$DEFAULT_OUTPUT_DIR`; optionally pushes with `--push`

## Key Variables

| Variable | Default | Purpose |
|---|---|---|
| `DEFAULT_OUTPUT_DIR` | `~/Programming/GIT/my-dotfiles` | Where backups land |
| `DOTFILES` | array in script | What gets backed up |
| `GIT_REMOTE` | _(unset)_ | Remote URL; required for `--push` |
| `GIT_BRANCH` | current branch | Branch to push to |

Set `GIT_REMOTE` and `GIT_BRANCH` in `~/.config/dot-backup/config`. To change backup destination, edit `DEFAULT_OUTPUT_DIR` at the top of the script.

## Adding Dotfiles

Add paths to the `DOTFILES` array. Relative paths = home dir. Absolute paths (starting `/`) = system files (copied preserving full path under `system/`).