Version Control

Every configuration file is tracked in an embedded Git repository (libgit2). Atomic commits, schema validation, Ed25519-signed commits, snapshots with restore, and branch-based sandboxes for safe experimentation.

Git Engine

Async operation processor: commit, checkout, branch, merge, status, backup.

Snapshots

Named commits with list, get, create, restore. Timeline UI widget.

Sandboxes

Branch-based config sandboxes: create, switch, delete, merge back.

Migration

Schema version detection, chained migration functions, auto-backup.

Directory Structure

Text

{repo_path}/
├── .git/                     # Embedded Git repository
├── layouts/
│   └── active.yaml           # LayoutConfig (pane tree + sizes)
├── app_state/
│   └── global.yaml           # AppStateConfig (theme, sidebar, rendering)
├── snapshots/
│   └── backup/               # Pre-migration backups
└── .tetrapus/
    └── commit_meta.json      # Ed25519 signature per commit

Auto-Save

Changes are debounced with a 30-second delay. schedule_save() marks for save; check_and_save() runs each frame and commits if the debounce has elapsed.

Questions?

Reach out for help with integration, deployment, or custom domain codecs.

Get Started Request a Demo