@monopi/extension-worktree

Monopi worktree pi extension.

Packages

Package details

extension

Install @monopi/extension-worktree from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@monopi/extension-worktree
Package
@monopi/extension-worktree
Version
0.6.1
Published
Aug 28, 2026
Downloads
257/mo · 26/wk
Author
ifiokjr
License
MIT
Types
extension
Size
30.7 KB
Dependencies
1 dependency · 5 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@monopi/extension-worktree

The worktree extension adds centralized git worktree awareness to monopi. It detects whether the current checkout is the main repository or a linked worktree, shows when the current worktree is pi-owned, and tracks owner and purpose metadata for pi-created worktrees. It provides /worktree commands for status, listing, opening, creating, and cleaning up worktrees. Pi-owned worktrees are created under shared pi storage namespaced by the canonical repository root, and cleanup focuses on pi-owned worktrees while leaving external ones alone unless you explicitly intervene.

Install

pi install npm:@monopi/extension-worktree

Commands

  • /worktree: show worktree status for the current repo.
  • /worktree status: same as above.
  • /worktree list: list linked worktrees and mark pi-owned ones.
  • /worktree open [branch|path]: open an existing worktree.
  • /worktree create <branch> [purpose]: create a pi-owned worktree.
  • /worktree cleanup <branch|path|id|all>: remove pi-owned worktrees.