Worktrees MCP operations. Pass T3's original string-keyed argument maps.
Tool availability depends on the authenticated server, permission mode and
invocation context. In-app agent tools may not be available to outside clients.
See T3.Catalog.tools(:worktrees) for descriptions and context requirements.
Summary
Functions
Move THIS thread into a new git worktree on a new branch. Runs the setup script by default. A separate agent in a worktree: t3_thread_launch with workspaceStrategy. Call last in your turn. The move ends the live session. continuationPrompt resumes work there next turn. Without it, the thread waits. The worktree stays after the thread is deleted. Fails if this thread has a worktree.
List branch refs and checkout paths for a thread's workspace. Omit threadId for this thread. Detached worktrees with no branch are left out.
Report this thread's worktree: attached or not, path, branch, project root, and the startFromOrigin default. Check before t3_worktree_handoff.
Functions
@spec handoff(T3.Client.t(), map()) :: {:ok, map()} | {:error, T3.Error.t()}
Move THIS thread into a new git worktree on a new branch. Runs the setup script by default. A separate agent in a worktree: t3_thread_launch with workspaceStrategy. Call last in your turn. The move ends the live session. continuationPrompt resumes work there next turn. Without it, the thread waits. The worktree stays after the thread is deleted. Fails if this thread has a worktree.
Some operations require a T3-launched agent/thread context. The server enforces tool visibility and permissions.
@spec list(T3.Client.t(), map()) :: {:ok, map()} | {:error, T3.Error.t()}
List branch refs and checkout paths for a thread's workspace. Omit threadId for this thread. Detached worktrees with no branch are left out.
Some operations require a T3-launched agent/thread context. The server enforces tool visibility and permissions.
@spec status(T3.Client.t(), map()) :: {:ok, map()} | {:error, T3.Error.t()}
Report this thread's worktree: attached or not, path, branch, project root, and the startFromOrigin default. Check before t3_worktree_handoff.
Some operations require a T3-launched agent/thread context. The server enforces tool visibility and permissions.