David Kong
dd2202f54c
## Summary Register all four git worktree tools with correct TypeBox schemas and placeholder implementations. ## Changes - Added `.pi/extensions/pi-worktree.ts` with four tool registrations: - `git_worktree_list` — no params, lists linked worktrees - `git_worktree_create` — path, branch?, create_branch? params - `git_worktree_switch` — target param for switching cwd - `git_worktree_remove` — path param for removing worktrees - Each tool returns "Not implemented yet." placeholder response ## Testing - [x] All four tools registered with correct TypeBox schemas - [x] Calling each tool returns a response (placeholder) - [ ] Extension loads without errors when pi starts (manual verification needed) ## Checklist - [ ] Self-reviewed the diff - [ ] Code follows project conventions - [ ] Descriptive naming (no single-character variables) Co-authored-by: David Kong <davkon@gmail.com> Reviewed-on: #15
82 lines
2.3 KiB
Markdown
82 lines
2.3 KiB
Markdown
# 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.
|
|
|
|
```typescript
|
|
{
|
|
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.
|
|
|
|
```typescript
|
|
// 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.
|
|
|
|
```typescript
|
|
{
|
|
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.
|
|
|
|
```typescript
|
|
{
|
|
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 `ExtensionAPI` and `registerCommand` support)
|
|
- Git 2.x with worktree support (all modern versions)
|
|
- No external npm dependencies — uses only pi's extension API and TypeBox schemas.
|