slots

Manage numbered git worktree pools with foreach execution and trunk fast-forwarding.

2|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/nseng-ai/ns --skill slots-nseng-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: slots
Source: https://github.com/nseng-ai/ns/tree/main/skills/incubating/slots
Command: npx skills add https://github.com/nseng-ai/ns --skill slots-nseng-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing many parallel git worktrees by hand is error-prone: running commands across all of them, keeping detached worktrees current with trunk, and re-approving direnv .envrc files per directory all require repetitive manual steps. ## Core Features & Use Cases - Pool-wide command execution: Run ns slot foreach to execute a command across the main worktree and all numbered Slots in order, with exclusion flags and failure aggregation. - Detached Slot refresh: Use ns slot ff-detached to fast-forward clean detached Slots to the configured local trunk while safely skipping attached, dirty, or divergent Slots. - direnv maintenance: Re-approve and warm .envrc files across every Slot after trunk changes, following the documented refresh process. - Use Case: After a shared .envrc change lands on trunk, fast-forward all detached Slots, then run ns slot foreach --yes -- direnv allow so every worktree unblocks its environment in one pass. ## Quick Start Ask the agent to fast-forward all detached Slots to trunk and then re-approve direnv across every worktree.

Frequently Asked Questions about slots

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a command across all git worktrees at once?

Use `ns slot foreach -- <command>` to execute a command in the main worktree first, then each numbered Slot in order. Pass a plain argv after `--`; for shell operators or globbing, invoke a shell explicitly with `ns slot foreach -- sh -c '...'`.

How do I update detached git worktrees to the latest trunk?

Run `ns slot ff-detached` to fast-forward clean detached Slots to the repository's configured local trunk. Attached, dirty, or divergent Slots are skipped as planned no-ops, and `--dry-run` shows intended outcomes without mutating anything.

Why does direnv show .envrc is blocked in my worktrees?

Direnv approves `.envrc` per directory, so each Slot blocks a changed `.envrc` until re-allowed. After the new `.envrc` reaches the worktrees, run `ns slot foreach --yes -- direnv allow` to re-approve every copy.

Can ns slot ff-detached update attached feature branches?

No, `ff-detached` only fast-forwards clean detached Slots and never modifies the main worktree or attached branches. Update attached branches through their normal branch workflow, such as rebasing or restacking.

What happens when a git operation is in progress in a worktree?

Any included worktree with a git operation in progress blocks the entire foreach run, and it blocks all mutation in ff-detached by default. Use `--force` on ff-detached to skip operation-bearing Slots and process the remaining safe ones.