safegit Documentation https://smmh.dev/safegit/ 2026-08-12T00:00:00Z safegit author https://smmh.dev/safegit/cli-author/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit backup https://smmh.dev/safegit/cli-backup/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit bisect https://smmh.dev/safegit/cli-bisect/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit checkout https://smmh.dev/safegit/cli-checkout/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit cherry-pick https://smmh.dev/safegit/cli-cherry-pick/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit commit https://smmh.dev/safegit/cli-commit/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit config https://smmh.dev/safegit/cli-config/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit doctor https://smmh.dev/safegit/cli-doctor/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit hook https://smmh.dev/safegit/cli-hook/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit CLI Reference https://smmh.dev/safegit/cli-index/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit merge https://smmh.dev/safegit/cli-merge/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit pull https://smmh.dev/safegit/cli-pull/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit push https://smmh.dev/safegit/cli-push/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit rebase https://smmh.dev/safegit/cli-rebase/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit reset https://smmh.dev/safegit/cli-reset/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit revert https://smmh.dev/safegit/cli-revert/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit scan https://smmh.dev/safegit/cli-scan/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit scrub https://smmh.dev/safegit/cli-scrub/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit undo https://smmh.dev/safegit/cli-undo/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit unlock https://smmh.dev/safegit/cli-unlock/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> safegit version https://smmh.dev/safegit/cli-version/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen (strictcli), do not edit --> API Reference https://smmh.dev/safegit/gen-index/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/commit https://smmh.dev/safegit/internal-commit/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/coord https://smmh.dev/safegit/internal-coord/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/filelock https://smmh.dev/safegit/internal-filelock/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/git https://smmh.dev/safegit/internal-git/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/hooks https://smmh.dev/safegit/internal-hooks/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/index https://smmh.dev/safegit/internal-index/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/lock https://smmh.dev/safegit/internal-lock/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/oplog https://smmh.dev/safegit/internal-oplog/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/procutil https://smmh.dev/safegit/internal-procutil/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/repo https://smmh.dev/safegit/internal-repo/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/scan https://smmh.dev/safegit/internal-scan/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/stage https://smmh.dev/safegit/internal-stage/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/submodule https://smmh.dev/safegit/internal-submodule/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/testutil https://smmh.dev/safegit/internal-testutil/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> internal/trailer https://smmh.dev/safegit/internal-trailer/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> safegit https://smmh.dev/safegit/safegit/ 2026-08-12T00:00:00Z <!-- generated by selfdoc gen, do not edit --> Commands Guide https://smmh.dev/safegit/commands-guide/ 2026-08-07T00: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. Integration Guide https://smmh.dev/safegit/integration-guide/ 2026-08-07T00: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. Concurrency Guide https://smmh.dev/safegit/concurrency-guide/ 2026-08-03T00: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. Architecture https://smmh.dev/safegit/architecture/ 2026-07-04T00: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 https://smmh.dev/safegit/ 2026-05-17T00:00:00Z Concurrency-safe git operations for multi-session worktrees. safegit Requirements https://smmh.dev/safegit/req/ 2026-05-17T00:00:00Z - Multiple AI agent sessions must be able to work on the same repo concurrently without worktrees - No shared mutable staging area -- agents must not be able to stage or commit each other's files - Commits must be serialized or isolated so that concurrent commits never produce corrupt or mixed results - If two agents edit the same file, the conflict must be surfaced as data, not silently lost or merged Git Alternatives for AI-Safe Concurrency https://smmh.dev/safegit/research/ 2026-05-17T00: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).