switch

Switch the session's execution context between the primary checkout and session worktrees.

9|Updated Jun 10, 2026
One-click install
npx skills add https://github.com/eventbalancer/agent-quorum --skill switch-eventbalancer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: switch
Source: https://github.com/eventbalancer/agent-quorum/tree/main/.agents/skills/switch
Command: npx skills add https://github.com/eventbalancer/agent-quorum --skill switch-eventbalancer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working with multiple git worktrees, it is easy to lose track of which directory the session is operating in, risking edits in the wrong tree. This Skill moves the session's working context between the primary checkout and linked session worktrees in a deliberate, verified way. ## Core Features & Use Cases - Context Resolution: Resolves a target by root keyword, slug, branch, or path via pnpm run worktree:switch, refusing to guess on ambiguous matches. - Safety Gating: Surfaces done status and active-edit markers before entering, prompting for confirmation when another session may be editing the target. - Verified Handoff: Enters the target with EnterWorktree/ExitWorktree or cd, then proves the move with git rev-parse --show-toplevel before any further commands run. - Use Case: You ask to work in the feature-auth worktree; the Skill resolves it, warns that it is marked done, enters it, and confirms the new working root before you edit anything. ## Quick Start Ask the agent to run /switch with a worktree slug, branch, path, or root to move the session into that context.

Frequently Asked Questions about switch

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

FAQPage Schema
How do I switch between git worktrees in a session?

Run /switch with a target: root for the primary checkout, or a slug, branch, or path for a worktree. The resolver prints from/to, branch, and kind, then the session enters the target and verifies the move with git rev-parse --show-toplevel.

How do I check which worktree my session is currently in?

Run /switch with no arguments. It reports the current path and kind, then lists available targets including root and every non-done session worktree with branch, task description, and edit status.

What happens if I switch into a worktree another session is editing?

The resolver reports an active-edit marker status that this session did not write. The Skill then asks for operator confirmation before entering, following the worktree selection gate's confirmation rule.

Can I edit a worktree that is marked done?

Entering a done worktree to inspect it is allowed, but before editing you should run pnpm run worktree:reopen <branch>. The Skill surfaces this hint when the target carries a done marker.

What are the limitations of the worktree switch command?

It only changes where commands run; it never creates, removes, reopens, or releases worktrees, and never integrates or rebases work. Ambiguous or unknown targets stop with an error rather than guessing.