1# git
2
3sublimated speaks git natively. clone, push, fetch, branch — standard git clients work without plugins.
4
5## URLs
6
7```
8git clone https://sublimated.com/{space}.git
9git clone https://sublimated.com/{space}/{folder}.git
10git clone https://sublimated.com/{space}/{folder}/{subfolder}.git
11```
12
13every folder in the tree is independently clonable with its own commit history.
14
15## hierarchical versioning
16
17when you change a file, commits are created at every ancestor level.
18
19change `anton/blog/archive/post.md`:
201. commit at `archive/`
212. commit at `blog/`
223. commit at `anton/` (space root)
23
24all atomic. each level has a self-contained git history with only the files under that path.
25
26## clone at any level
27
28```bash
29git clone https://sublimated.com/anton.git              # whole space
30git clone https://sublimated.com/anton/blog.git          # just blog + children
31git clone https://sublimated.com/anton/blog/archive.git  # just archive
32```
33
34each clone gets only files and commits relevant to that subtree. no sparse-checkout needed.
35
36## auth
37
38use your API token as git credentials:
39
40```bash
41# in the URL
42git clone https://token:sk_abc123@sublimated.com/anton/notes.git
43
44# or when prompted
45Username: token
46Password: sk_abc123
47```
48
49## creating folders
50
51push to a path that doesn't exist yet — sublimated creates it automatically.
52
53```bash
54mkdir my-project && cd my-project
55git init
56echo "# hello" > README.md
57git add . && git commit -m "initial"
58git remote add origin https://sublimated.com/anton/my-project.git
59git push -u origin main
60```
61
62## branches
63
64branches are scoped to the folder level where they're created.
65
66create branch `draft` on `anton/blog/archive`:
67- visible when you clone `anton/blog/archive`
68- not visible when you clone `anton/blog`
69
70when you merge a scoped branch, the changes cascade up to the space root on the default branch.
71
72## tags
73
74```bash
75git tag v1.0
76git push origin v1.0
77```
78
79lightweight and annotated tags both work. tags are immutable — updating requires `--force`.
80
81## works with everything
82
83because it's standard git, your existing tools work:
84- any git GUI (Tower, Fork, GitKraken, etc)
85- CI/CD pipelines
86- `git log`, `git diff`, `git blame`, `git bisect`
87- VS Code, JetBrains, Xcode — anything that speaks git