Files
paseo/plugin-examples/worktrunk
Mohamed Boudra ba325922d2 fix(plugins): preserve worktree setup on retry and refresh branch bases
A failed setup could leave a new branch behind and send the retry through the built-in checkout. Use the manager's reported branch creation status during rollback. Share base preparation so both checkout paths start from the updated remote-tracking ref.
2026-11-20 10:16:51 +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