plan-bender-cli

Map pb and pba subcommands to operational semantics for dispatch and worktree lifecycle.

5|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/jasonraimondi/plan-bender --skill plan-bender-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-bender-cli
Source: https://github.com/jasonraimondi/plan-bender/tree/main/skills/plan-bender-cli
Command: npx skills add https://github.com/jasonraimondi/plan-bender --skill plan-bender-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

plan-bender-cli helps you understand and operate the plan-bender toolchain for turning an idea into dependency-ordered implementation work, and it provides a reliable way to run, inspect, recover, and dispatch that workflow.

Core Features & Use Cases

  • Command reference for plan-bender: Answers what pb and pba do, which subcommands exist, and how to use them for setup, dispatch, status, retries, worktrees, syncing, and docs.
  • Dispatch lifecycle control: Explains how pb dispatch / pba dispatch determines the integration branch, runs per-issue worktrees, enforces subprocess timeouts, performs dependency-ordered merge-back, and exits with clear codes.
  • Operational recovery: Supports troubleshooting a stuck dispatch using pb status and pb retry while preserving audit notes and ensuring safe resumption.

Quick Start

Run pb dispatch <slug> to execute the autonomous implementation loop for your plan and continuously merge completed work back in dependency order.

Frequently Asked Questions about plan-bender-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run autonomous dispatch workflows for AI coding tasks?

You can run an autonomous dispatch workflow using `pb dispatch <slug>`, which executes the implementation loop, runs per-issue worktrees, enforces subprocess timeouts, and continuously merges completed work back in dependency order.

How does git worktree lifecycle management work during agent orchestration?

Git worktree lifecycle management during dispatch creates isolated worktrees for each issue, allowing autonomous agents to operate safely before performing a dependency-ordered merge-back into the integration branch.

What are the preconditions for dispatching an autonomous coding agent?

Dispatching an autonomous coding agent requires a clean git state as a precondition, ensuring the working directory is free of uncommitted changes before the dispatch execution begins processing issues.

How do I recover a stuck dispatch workflow and preserve audit notes?

To recover a stuck dispatch workflow, use `pb status` to inspect the current state and `pb retry` to safely resume execution, which preserves audit notes while clearing blocked issues.

What do plan-bender exit codes indicate during workflow execution?

Exit codes during workflow execution indicate the success or specific failure state of the dispatch process, providing clear reporting on whether subprocess timeouts, dependency-ordered merge-back, or completion sentinels triggered an error.

How does Linear sync behavior work within an AI coding workflow?

Linear sync behavior within an AI coding workflow updates issue tracking status during dispatch execution, ensuring that completion sentinels and blocked issues are accurately reflected in the Linear project management system.