Files
paseo/plugin-examples/worktrunk
Mohamed Boudra cbaa8c7c90 fix(plugins): verify managed worktree ownership and restore targets
A failed callback does not establish ownership of worktrees created during its call. Require the manager to identify the checkout before Paseo attempts rollback, and verify the requested Git target before reopening a restored workspace.
2026-11-20 10:04:45 +01:00
..

Worktrunk plugin example

Delegates Paseo worktree creation, removal, and restoration to Worktrunk (wt), and updates wt list activity markers (🤖 / 💬) as agents run.

What it does

  • Create: routes branch-off, branch checkout, GitHub PR (pr:N), and GitLab MR (mr:N) creation through wt switch --no-cd --yes --format=json so Worktrunk controls placement, branch setup, and pre-start / post-start hooks. Unsupported forges decline and fall back to Paseo's Git checkout.
  • Remove: routes archive and creation rollback through wt remove --foreground --no-delete-branch --yes so Worktrunk runs pre-remove and post-remove hooks while keeping the branch for Paseo's restore flow.
  • Restore: routes archived worktree restoration through wt switch --path <recorded-path> for branch restores, and falls back to Paseo for detached-commit restores.
  • Activity markers: sets 🤖 when an agent turn starts, 💬 when a turn ends or awaits permission, and clears the marker on close or archive. Background helpers are skipped.

Prerequisites

Install Worktrunk (wt, or git-wt.exe on Windows) on PATH, or set WORKTRUNK_BIN in the daemon environment.

Install

paseo plugin install /absolute/path/to/plugin-examples/worktrunk