aspiers/ai-config / .agents/skills/setting-up-worktree-hooks
setting-up-worktree-hooks
VerifiedGives a repository one idempotent, repo-local worktree setup script (local env files, dependency install, build steps) that worktrunk's `.config/wt.toml` pre-start hook and Orca's `orca.yaml` scripts.setup both call, so every new git worktree is usable at once. Use when adding or fixing worktree setup hooks, writing `wt.toml` or `orca.yaml` setup, when new worktrees lack dependencies or `.env` files, or when asked to make worktrees "just work" in a repo. For creating a worktree in a repo that already has setup, use `git-branch-management` instead.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.1 KB |
| references/hooks.md | markdown | 3.4 KB |
| references/worktree-setup.mts | other | 4.5 KB |
| references/worktree-setup.sh | script | 2.7 KB |
references/worktree-setup.sh
View on GitHub#!/bin/sh
#
# Example only: adapt the file list and setup steps to the target repository.
#
# Makes a new git worktree of this repository usable straight away. Both
# worktrunk (.config/wt.toml pre-start) and Orca (orca.yaml scripts.setup)
# call this, so every worktree gets the same setup however it was created.
# Safe to re-run: every step either skips work already done or is itself
# idempotent.
#
# Usage: sh scripts/worktree-setup.sh
#
# Run from anywhere inside the new worktree. It finds the primary checkout
# itself, so no tool-specific environment variable is needed.
set -e
cd "$(git rev-parse --show-toplevel)"
# The first `git worktree list` entry is the main worktree. For a bare
# repository, or one made with --separate-git-dir, that entry is the
# metadata directory rather than a checkout, so trust it only if it is its
# own work tree. Otherwise leave primary empty rather than guessing: a
# guessed directory, such as the parent of a bare repo, could hold an
# unrelated .env.local. The -n test matters: `git -C ""` means the current
# directory. The rev-parse failure is expected for a bare repo, so its
# stderr is discarded.
primary=
candidate=$(git worktree list --porcelain | sed -n '1s/^worktree //p')
if [ -n "$candidate" ] &&
top=$(git -C "$candidate" rev-parse --show-toplevel 2>/dev/null) &&
[ "$(cd "$top" && pwd -P)" = "$(cd "$candidate" && pwd -P)" ]; then
primary=$candidate
fi
# Gitignored files the app reads at runtime. Each is linked, not copied, so
# a rotated secret reaches every worktree from one source of truth.
LOCAL_FILES=".env.local"
if [ -z "$primary" ]; then
echo "worktree setup: no primary checkout (bare repository or separate git dir); skipped linking local files."
elif [ "$(pwd -P)" = "$(cd "$primary" && pwd -P)" ]; then
echo "worktree setup: in the primary checkout; skipped linking local files."
else
for file in $LOCAL_FILES; do
# A dangling link fails `-e`, so `-L` stops `ln` from aborting a re-run
# under `set -e` after the primary's file was removed.
if [ -e "$file" ] || [ -L "$file" ]; then
echo "worktree setup: $file already present; left untouched."
elif [ -f "$primary/$file" ]; then
mkdir -p "$(dirname "$file")"
ln -s "$primary/$file" "$file"
echo "worktree setup: linked $file from the primary checkout."
else
echo "worktree setup: no $file in the primary checkout; skipped."
fi
done
fi
# Replace with this repository's own install and build steps. Hard failures
# should stop setup; steps that only fail on a flaky network can warn
# instead, as long as a later step would catch a genuinely broken install.
npm install
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |