worktrunk
Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows
Discover how Worktrunk renders output progressively using stream() and delayed_stream() for responsive terminal feedback and full command traceability.
Layering Strategy for Repository Caching in Worktrunk: Two-Layer Architecture ExplainedDiscover Worktrunk's dual-layer repository caching strategy. Learn how static caches and RepoCache instances accelerate Git data retrieval for efficient CLI commands.
How Worktrunk Manages Configuration Deprecation and MigrationLearn how Worktrunk manages configuration deprecation with an idempotent migration engine. It transforms legacy TOML patterns in-memory, deduplicates warnings, and guides users to explicit updates.
How Worktrunk Ensures Data Safety During File Writes: Atomic Operations ExplainedLearn how Worktrunk ensures data safety with atomic file writes. Discover the `write_atomically` and `write_new_atomically` helpers for guaranteed data persistence.
How Worktrunk Centralizes Signal Handling for Child ProcessesDiscover how Worktrunk centralizes signal handling for child processes using a two-tier architecture for seamless signal capture and consistent exit code propagation.
Default Branch Detection in Worktrunk: A Three-Stage Caching StrategyDiscover Worktrunk's efficient default branch detection using a three-stage cache. Learn how it ensures CLI responsiveness even offline or with high latency.
Worktrunk Network Access Policy: A Local-First Approach to Bounding Network AccessDiscover Worktrunk's local-first network access policy. Learn how it bounds network access, treating operations as exceptions for offline Git and explicit remote fetches.
How Worktrunk Handles Network Requests for CI Status and PR DetailsDiscover how Worktrunk efficiently fetches CI status and PR details by using background CLI commands, caching results, and updating the UI via file-system events without blocking the main thread.
When Are Background Hook Pipelines Spawned Concurrently in Worktrunk?Discover when Worktrunk's background hook pipelines spawn concurrently. Learn how post-hooks launch simultaneously after command success for efficient workflow automation.
How Project-Defined Hooks Are Gated and Approved in WorktrunkLearn how Worktrunk gates and approves project-defined hooks through a two-step mechanism involving HookPlans and explicit approval before freezing into an immutable ApprovedHookPlan.
How Worktrunk Prevents TOCTOU Vulnerabilities in Hook ExecutionLearn how Worktrunk prevents TOCTOU vulnerabilities by freezing approved hooks at the approval boundary, ensuring security during operation.
Understanding the Worktrunk Hook Security Model: Gate-by-Approval ProtectionDiscover the Worktrunk hook security model. Learn how Gate-by-Approval protects against untrusted code execution from cloned repositories, ensuring robust project safety.
Have a question about this repo?
These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:
curl -s "https://instagit.com/install.md" 
Maintain an open-source project? Get it listed too →