git-worktree-status

To check background build and test tasks in a git worktree, run a status command that reads the .worktree-logs directory and reports per-check outcomes for typecheck, tests, and builds. This provides a concise health report without interrupting development.

Non-blocking git worktree health checking is a mechanism that surfaces the results of background verification tasks by parsing logs, allowing developers to view typecheck, test, and build statuses without interrupting their active development workflow.

You can get a status report for typecheck, tests, and builds by executing the status command inside your worktree, which parses the .worktree-logs and generates a deterministic report with per-check outcomes and remediation guidance.

The git worktree status check requires no special dependencies, but it applies only when operating inside a git worktree that contains a .worktree-logs directory populated by your background verification tasks.

When a worktree health check reports a failure, you should follow the generated remediation guidance, which delivers a deterministic status report with per-check outcomes to help you quickly identify and resolve the failing typecheck, test, or build activity.

You cannot use this health check outside of a git worktree, because the mechanism specifically detects the current worktree and locates related logs in the .worktree-logs directory to parse typecheck, tests, and build results.