hierarchical versioning

this is what makes sublimated different from GitHub, GitLab, or any other git host. every folder in your space has its own independent git history, and changes cascade commits from the file level up to the root.

how it works

a space is a tree. when you change a file, sublimated creates commits at every level of the tree.

change docs/markdown/syntax.md:

docs/markdown/syntax.md   ← file changed
docs/markdown/             ← commit created here
docs/                      ← commit created here (space root)

all commits are created in one atomic transaction. each level's commit contains a tree rooted at that level — only the files under that folder.

clone any folder

because real commits exist at every level, you can clone any folder independently:

git clone https://sublimated.com/docs.git              # whole space
git clone https://sublimated.com/docs/git.git           # just git docs
git clone https://sublimated.com/docs/markdown.git      # just markdown docs

each clone gets:

• only files under that path

• only commits that touched that subtree

• branches scoped to that level

• a clean, self-contained git history

no sparse-checkout, no filtering. the server gives you a real git repo for that folder.

what this enables

the hierarchical model gives you several things without needing separate products:

• gists — a single file in a folder is a gist with version history

• dotfiles — clone on any machine, push changes, version history

• personal storage — private space with file history, clone and sync anywhere

• scoped access — each team clones only the folders they need

• dataset versioning — every change tracked, any version reproducible, clone a subset for experiments

• agent workspace — an AI agent clones a folder, works in it, pushes results with full history

version history per folder

browse to any folder on sublimated.com and you see its commit history — only the changes that affected that folder and its children. no noise from unrelated parts of the space.

sublimated.com/docs/markdown  →  shows commits that touched markdown/
sublimated.com/docs/git       →  shows commits that touched git/
sublimated.com/docs           →  shows all commits in the space

same for git log after cloning — you only see relevant history.

how it compares

on GitHub, a repo is the atomic unit. on sublimated, a folder is.

see git overview for how to clone and push, or branches for how branch scoping works with the hierarchy.