David Kong
3d1b2f5443
## Summary Implement the `git_worktree_list` tool that parses `git worktree list` output into structured data with path, branch, commit hash, and current directory marker. ## Changes - Implemented `parseWorktreeList()` helper to parse raw `git worktree list` output - Handles standard branches (e.g., `[main]`) - Handles detached HEAD (marked as `(detached)`) - Marks the current working directory with `isCurrent: true` - Wired parser into `git_worktree_list` tool execute function - Returns both formatted display text and structured `details.worktrees` array - Added error handling for non-git-repo directories - Restructured tool definitions inside extension factory to capture `pi` via closure ## Testing - [x] Parsing logic verified against real `git worktree list` output (3 worktrees) - [ ] Manual verification in pi TUI pending extension load test ## Checklist - [x] Self-reviewed the diff - [x] Code follows project conventions (AGENTS.md, DESIGN.md, DOMAIN.md) - [x] Descriptive naming (no single-character variables) - [x] Error handling with clear messages and suggestions Co-authored-by: David Kong <davkon@gmail.com> Reviewed-on: #16 |
||
|---|---|---|
| .pi/extensions | ||
| main@cd51baa2c1 | ||
| .gitignore | ||
| AGENTS.md | ||
| bunfig.toml | ||
| DESIGN.md | ||
| DOMAIN.md | ||
| package.json | ||
| README.md | ||
pi-worktree
A pi extension for managing git worktrees through intuitive tool commands and an interactive picker.
Tools
git_worktree_create
Create a linked worktree for a branch in the current repo.
{
path: string, // Path for the new worktree
branch?: string, // Branch name (new or existing). Defaults to 'main'.
create_branch?: boolean // Create a new branch? Defaults to true if branch doesn't exist.
}
Example: git_worktree_create({ path: "./feature-x", branch: "feature-x" })
git_worktree_list
List all linked worktrees in the current repo.
// No parameters required
Returns structured data with branch, path, and isCurrent for each worktree.
Example output (raw git worktree list format, parsed into structured data):
/home/user/repo abc1234 [main]
/home/user/repo/feature-x def5678 [feature-x]
git_worktree_switch
Switch pi's working directory to a linked worktree.
{
target: string // Path or branch name of the target worktree
}
Example: git_worktree_switch({ target: "./feature-x" })
After switching, you'll be offered the option to create a new session for that worktree context.
git_worktree_remove
Remove a linked worktree.
{
path: string // Path of the worktree to remove
}
Example: git_worktree_remove({ path: "./feature-x" })
Command
/worktree
Interactive picker to switch between linked worktrees.
Lists all worktrees with a branch-first display and lets you select one to switch to. Automatically updates pi's branch display after switching.
Behavior
- Fail fast: Refuses dangerous operations (existing paths, current branch, uncommitted changes) with clear messages and suggested fixes.
- Stateless tools: Each call works independently based on current git state.
- Session integration: Branch display updates automatically; you're offered a new session after switching worktrees.
- Back-switching: When returning to the main repo, pi restores the previous session.
Requirements
- pi >= 0.5.0 (with
ExtensionAPIandregisterCommandsupport) - Git 2.x with worktree support (all modern versions)
- No external npm dependencies — uses only pi's extension API and TypeBox schemas.