index.md

Tutorials

Getting Started

• Getting Started — Init a repo, add files, commit, branch, merge, and other everyday commands
• Configuration — Read and write repo-local config (modes, CDC parameters)

Remotes and Sync

• Cloud Remotes — Push and pull binary files to cloud storage via rclone
• Filesystem Remotes — Sync to USB drives, NAS, and local paths
• Bare Remotes — CAS-only remotes for efficient storage without full file layout
• Metadata Remotes — Lightweight remotes that sync only git metadata
• Remote Commands — Run bit commands against a remote without a local clone

Storage

• Modes and CAS — Lite vs solid mode, the content-addressed store, and restoring old versions

Collaboration

• Conflict Resolution — Handle divergence: accept-remote, force push, manual merge
• Submodules — Nest git and bit repos as submodules

Verification

• Verify and Repair — Check file integrity and repair from remotes

Git Interop

• Git Import — Convert an existing git repo to bit
• Git Export — Convert a bit repo back to git
• Git Router — Use bit as a drop-in replacement for git