Skip to main content
Documentation
Guides

Glossary

Definitions of key terms and concepts used throughout the Dits documentation.

B

BLAKE3

The cryptographic hash function Dits uses for current content identifiers. A digest detects changed bytes but is not an author signature.

Blob

The raw content of a file stored in the repository. In Dits, blobs are chunked and deduplicated.

Branch

An independent line of development. Branches allow you to work on features without affecting the main codebase.

C

Chunk

A portion of file content created by the chunking algorithm and stored locally by its BLAKE3 identifier.

Clone

Creating a repository copy. Dits currently supports clone from another local filesystem path only; network clone fails.

Commit

A snapshot of your repository at a point in time. Each commit has a unique identifier and records changes made since the last commit.

Content Addressing

Identifying content by its cryptographic hash rather than its location. This enables deduplication - identical content is stored only once.

Content-Defined Chunking (CDC)

A chunking algorithm that determines chunk boundaries based on file content rather than fixed sizes. This improves deduplication when files are modified.

D

Deduplication

The process of eliminating duplicate copies of data. In Dits, identical chunks are stored only once, saving storage space.

F

FastCDC

The default chunking algorithm in Dits. It's a fast, efficient content-defined chunking implementation optimized for large files.

Fetch

A roadmap remote operation. The current command returns a nonzero error without changing objects, refs, or the working tree.

FUSE

Filesystem in Userspace. Dits has an experimental, local-only mount path behind the optional fuser Cargo feature.

H

Hash

A fixed-size identifier computed from content. Dits uses BLAKE3 for its content-addressed objects and chunks.

HEAD

A reference to the currently checked-out commit. Usually points to the tip of the current branch.

Hook

A local script associated with a supported Dits workflow event, such as a commit step.

Hydration

Materializing file bytes from objects already available to a local repository. Remote on-demand hydration is not implemented.

I

Index

Also called the staging area. A snapshot of files you've marked to include in the next commit.

L

Lock

A local advisory record of editing intent. Current locks are not synchronized, remote leases, authorization, or enforcement against other tools.

M

Merge

Combining changes from different branches into a single branch. Dits supports various merge strategies.

Mount

An experimental local FUSE view, available only in source builds that enable the fuser feature. It does not fetch from a remote.

O

Origin

A conventional remote configuration name. Local clone records its source path as origin, but remote transfer remains disabled.

P

P2P (Peer-to-Peer)

Planned direct repository exchange between peers. Current P2P code is nonfunctional scaffolding and transfers no repository data.

Proxy File

A low-resolution or placeholder version of a large file. Used for preview while keeping full-quality originals available.

Pull

A roadmap remote operation. The current command returns a nonzero error without changing objects, refs, or the working tree.

Push

A roadmap remote operation. The current command returns a nonzero error and uploads no repository data.

R

Rebase

Replaying commits from one branch onto another. Creates a linear history by avoiding merge commits.

Ref

Short for reference. A pointer to a commit, typically a branch name or tag.

Remote

A named URL stored in local configuration. Saving one does not enable repository exchange in the current alpha.

Repository (Repo)

A directory containing your project files and the complete history of changes, stored in the .dits directory.

S

Sparse Checkout

Selecting local paths for the working tree. It is not network partial clone or remote on-demand hydration.

Stage

Marking changes to include in the next commit. Done with 'dits add'.

Stash

Temporarily storing uncommitted changes so you can work on something else, then restore them later.

Storage Tier

A lifecycle label used by local freeze/thaw experiments. Automatic cloud-tier movement is not a current capability.

T

Tag

A named reference to a specific commit, typically used to mark release versions.

Tree

An object representing a directory. Trees contain references to blobs (files) and other trees (subdirectories).

V

VFS (Virtual Filesystem)

The experimental local FUSE mount path. It is feature-gated and does not provide remote hydration.

W

Wire Protocol

A future repository-exchange contract. No complete Dits client/server wire protocol is implemented today.

Working Directory

The directory containing your actual project files. Changes here are tracked by Dits.

Related Resources