safegit Documentation https://smmh.dev/safegit/ 2026-09-14T00:00:00Z git wrapper CLI that gives each commit its own temporary index and retries ref updates on conflict, so concurrent agents share one repository Architecture https://smmh.dev/safegit/architecture/ 2026-09-14T00:00:00Z This document captures safegit's design rationale and architectural specification: why it exists in its current shape, how the commit pipeline achieves concurrency safety, and how failure modes are detected and recovered. safegit author https://smmh.dev/safegit/cli-author/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit backup https://smmh.dev/safegit/cli-backup/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit bisect https://smmh.dev/safegit/cli-bisect/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit cherry-pick-continue https://smmh.dev/safegit/cli-cherry-pick-continue/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit cherry-pick https://smmh.dev/safegit/cli-cherry-pick/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit commit https://smmh.dev/safegit/cli-commit/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit config https://smmh.dev/safegit/cli-config/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit doctor https://smmh.dev/safegit/cli-doctor/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit hook https://smmh.dev/safegit/cli-hook/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit CLI Reference https://smmh.dev/safegit/cli-index/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit merge-continue https://smmh.dev/safegit/cli-merge-continue/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit merge https://smmh.dev/safegit/cli-merge/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit mv https://smmh.dev/safegit/cli-mv/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit pull https://smmh.dev/safegit/cli-pull/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit push https://smmh.dev/safegit/cli-push/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit rebase https://smmh.dev/safegit/cli-rebase/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit reset https://smmh.dev/safegit/cli-reset/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit revert-continue https://smmh.dev/safegit/cli-revert-continue/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit revert https://smmh.dev/safegit/cli-revert/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit scan https://smmh.dev/safegit/cli-scan/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit scrub https://smmh.dev/safegit/cli-scrub/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit switch https://smmh.dev/safegit/cli-switch/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit undo https://smmh.dev/safegit/cli-undo/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit unlock https://smmh.dev/safegit/cli-unlock/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit version https://smmh.dev/safegit/cli-version/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> Commands Guide https://smmh.dev/safegit/commands-guide/ 2026-09-14T00:00:00Z safegit is a concurrency-safe git wrapper providing atomic commits, oplog-based undo, history rewriting, and multi-agent coordination. This guide covers every command in detail. Concurrency Guide https://smmh.dev/safegit/concurrency-guide/ 2026-09-14T00:00:00Z This guide explains safegit's concurrency model: what problems arise when multiple AI sessions share a git worktree, how safegit solves them, and what guarantees it provides. Divergences https://smmh.dev/safegit/divergences/ 2026-09-14T00:00:00Z safegit wraps git, so every command it offers stands next to something git already does. Most of the time the two agree. This document is the catalog of the places where they do not, or where they only appear to. API Reference https://smmh.dev/safegit/gen-index/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> safegit https://smmh.dev/safegit/ 2026-09-14T00:00:00Z Concurrency-safe git operations for multi-session worktrees. Integration Guide https://smmh.dev/safegit/integration-guide/ 2026-09-14T00:00:00Z safegit is designed to be embedded in automated workflows and AI agent toolchains. This guide covers how safegit interacts with external tools and how to configure those integrations. internal/commit https://smmh.dev/safegit/internal-commit/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/conflict https://smmh.dev/safegit/internal-conflict/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/coord https://smmh.dev/safegit/internal-coord/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/exitcode https://smmh.dev/safegit/internal-exitcode/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/filelock https://smmh.dev/safegit/internal-filelock/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/git https://smmh.dev/safegit/internal-git/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/gitexec https://smmh.dev/safegit/internal-gitexec/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/gitversion https://smmh.dev/safegit/internal-gitversion/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/hooks https://smmh.dev/safegit/internal-hooks/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/index https://smmh.dev/safegit/internal-index/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/lock https://smmh.dev/safegit/internal-lock/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/oplog https://smmh.dev/safegit/internal-oplog/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/procutil https://smmh.dev/safegit/internal-procutil/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/repo https://smmh.dev/safegit/internal-repo/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/scan https://smmh.dev/safegit/internal-scan/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/sequencer https://smmh.dev/safegit/internal-sequencer/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/stage https://smmh.dev/safegit/internal-stage/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/submodule https://smmh.dev/safegit/internal-submodule/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/testutil https://smmh.dev/safegit/internal-testutil/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/trailer https://smmh.dev/safegit/internal-trailer/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> safegit Requirements https://smmh.dev/safegit/req/ 2026-09-14T00:00:00Z > **Historical document.** This is the original requirements list, kept as the > record of what safegit was asked for. It is not a description of the built > tool, and where the two differ the implementation is the authority -- see > [Architecture](architecture.md) and the [Concurrency Guide](concurrency-guide.md). > One difference is worth naming here, because the requirement below states the > opposite: **the lock does poll.** Waiters use exponential-backoff polling > (10ms to a 1s cap, bounded by `lock.acquireTimeoutSeconds`), with the backoff > reset whenever the lock is observed to have changed hands. No notification > mechanism was built; the requirement's real goal -- that no human has to > intervene -- is met by automatic stale-lock reclamation. Git Alternatives for AI-Safe Concurrency https://smmh.dev/safegit/research/ 2026-09-14T00:00:00Z The core problem: Git's staging area (`.git/index`) is a single global file per worktree. When multiple AI agent sessions run `git add` / `git commit` concurrently, they race on this shared resource -- one session can accidentally commit another's staged files, or overwrite the index mid-operation. Worktrees are the standard mitigation but add complexity and have their own edge cases (stale lock files, orphan branches). safegit https://smmh.dev/safegit/safegit/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit --> scripts https://smmh.dev/safegit/scripts/ 2026-09-14T00:00:00Z <!-- generated by selfdoc gen, do not edit -->