@feniix/pi-devtools

Devtools extension for pi — branch and PR workflow, release automation, and merge commands.

Features

• Git Workflow Tools: Create branches, commit, push, create PRs
• Merge Commands: Merge or squash-merge PRs with observable, worktree-safe branch cleanup
• Release Automation: Analyze commits, bump versions, generate changelogs, create releases
• CI Status Checking: Check GitHub Actions status before merging or releasing

Install

pi install npm:@feniix/pi-devtools

Ephemeral (one-off) use:

pi -e npm:@feniix/pi-devtools

Active Working Directory and Worktrees

Every tool runs Git, GitHub CLI, and repository-relative file operations in Pi's active working directory (active cwd), not the extension process directory. devtools_get_repo_info reports the active worktree root, linked worktree context, detached HEAD state, Git directories, and all parsed worktree records.

When merge cleanup is requested, remote and local cleanup are attempted and reported separately. Occupied branches are retained when checked out by the active or another linked worktree, including locked or conservatively retained prunable records. A retained branch or cleanup failure does not change a successful merge into a failed merge.

The extension observes worktree topology for safety, but it will never create, remove, unlock, or prune worktrees. It also does not switch to or update the default branch after a merge.

Tools

Branch & PR Tools

| Tool | Description | |------|-------------| | devtools_create_branch | Create and switch to a new git branch | | devtools_commit | Stage files and create a commit with conventional format | | devtools_push | Push branch to remote with upstream tracking | | devtools_create_pr | Create a GitHub pull request | | devtools_get_repo_info | Get active worktree, linked/detached context, default branch, and status |

Merge Tools

| Tool | Description | |------|-------------| | devtools_merge_pr | Merge a PR with optional best-effort remote and local branch cleanup | | devtools_squash_merge_pr | Squash-merge a PR with optional best-effort remote and local branch cleanup | | devtools_check_ci | Check CI status for a PR or the current branch |

Release Tools

| Tool | Description | |------|-------------| | devtools_get_latest_tag | Get the latest version tag from git | | devtools_analyze_commits | Analyze commits since last tag to determine version bump | | devtools_bump_version | Update version in package.json | | devtools_create_release | Create a GitHub release with changelog |

Skills

• brpr: Branch, commit, push, and open PR workflow
• release: Automated release process with changelog generation
• merge: Merge or squash-merge PRs

Configuration

Required: GitHub CLI

The gh CLI must be installed and authenticated:

gh auth login

Optional: Default Branch

The extension auto-detects the default branch, but you can set it explicitly:

export DEFAULT_BRANCH=main  # or 'master'

Requirements

• pi v0.51.0 or later
• git CLI
• gh CLI (authenticated)
• jq (for JSON parsing)

License

MIT