You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
One-paragraph description: Git worktree management plugin for the Pi agent harness. Provides safe create/list/remove of worktrees for parallel agent sessions, with guardrails against the data-loss patterns common in agentic workflows.
Status: 0.1.0 — in development
Install: pi install npm:@randomm/pi-worktree (once published) or manual copy to ~/.pi/agent/extensions/
Configuration: settings.json snippet if applicable
Safety guarantees: reference the footguns we explicitly guard against (branch-already-checked-out, dirty-remove, prune-before-delete, detached-HEAD, locked-leftover)
PR rules: include Fixes #N in PR body (not title); pass --base main to gh pr create
Reference AGENTS.md for the full agent-driven workflow
.github/ISSUE_TEMPLATE/
bug_report.md
feature_request.md
chore.md
Use the same template shapes pi-permissions evolved: title prefix, scope, why, acceptance criteria, out-of-scope, link to AGENTS.md if relevant.
Why
Readme is the front door. CONTRIBUTING tells humans how to send patches. Issue templates keep future issues at the quality bar pi-permissions reached only after several rounds of editing.
Acceptance criteria
README.md present with all 8 sections
CONTRIBUTING.md present with setup, gates, commit/PR rules
Three issue templates under .github/ISSUE_TEMPLATE/
License section in README says Apache 2.0 and links to LICENSE
No outdated MIT references anywhere
Out of scope
Detailed API docs (those live in JSDoc on exported types)
What
Discoverability and onboarding. Three small docs.
README.md (~80-120 lines)
CONTRIBUTING.md
.github/ISSUE_TEMPLATE/
Use the same template shapes pi-permissions evolved: title prefix, scope, why, acceptance criteria, out-of-scope, link to AGENTS.md if relevant.
Why
Readme is the front door. CONTRIBUTING tells humans how to send patches. Issue templates keep future issues at the quality bar pi-permissions reached only after several rounds of editing.
Acceptance criteria
Out of scope