Skip to content

playbook 0.43.0

Latest

Choose a tag to compare

@github-actions github-actions released this 12 Nov 13:08
· 67 commits to main since this release
ef61c26

Summary

playbook 0.43.0 shortens the command names, merges the two review commands into one, and makes usage tracking work per account. The status line now shows what your next message will cost. Setup also repairs the telemetry settings that kept interactive sessions from sending usage data.

Breaking changes

  • /playbook:quick-review and /playbook:deep-review are gone. Use /playbook:review. It looks at the diff, recommends a quick or a deep review, and asks you to pick. Pass --quick or --deep to skip the question. These two commands have no stub. (#1759)
  • /playbook:commit-and-push is now /playbook:commit. (#1750)
  • PR size limits are gone. playbook pr prepare and playbook deliver no longer refuse or warn on large diffs, and the pr prepare JSON has no checks.size field. segment resplit is removed, and so are the deliver --allow-large and segment size --limit flags. The engineering standards now ask for PRs that are small but complete for one area or feature, and test code does not count toward size. (#1786)

Other commands have new, shorter names. Each old name still works as a stub that prints the new name and then runs it. The stubs go away in 1.0.0.

Old name New name
/playbook:commit-and-push /playbook:commit
/playbook:create-pull-request /playbook:pr-create
/playbook:address-pr-comments /playbook:pr-comments
/playbook:session-handoff /playbook:handoff-save
/playbook:session-start /playbook:handoff-show
/playbook:learn-project /playbook:learn
/playbook:repo-audit /playbook:audit

What to do: update saved prompts and scripts that call the old names. The full list is in docs/renamed.md.

New features

Usage by account. If you use more than one Claude account, playbook usage --account <key or name> and pbtop --account now show one account at a time. The summary and the JSON output name the account. An unknown account exits with an error that points to playbook usage account list. In pbtop, every panel follows the account you pick, and telemetry queries filter by it. (#1778, #1779, #1780) A new recipe explains how to fix rows that carry the wrong account label. (#1781)

Next message cost in the status line. Line 3 of the status line shows an estimate of what the next message will cost, in place of the old cost per minute. It also shows how long the prompt cache stays warm, and a red ! cold cache warning once it expires. A cold cache costs much more: Claude writes the whole context again at the cache write price. The estimate counts input tokens only and is a lower bound. (#1772, #1773, #1774)

Telemetry repair in setup. playbook setup now repairs missing or stale OpenTelemetry keys in the Claude Code settings. It also removes IS_DEMO from the settings, because Claude Code sends no telemetry from interactive sessions while it is set. playbook uninstall puts it back. (#1769, #1770, #1771)

pbtop layout. A tab can hold up to 8 panels, and pbtop arranges them for you. Every chart is on the first tab by default. The Budget strip now uses bars with a pace marker, holds the projection, and has an hourly chart. (#1745, #1749, #1753, #1754)

Fixes

  • The session start no longer warns about missing telemetry keys when the keys are in place. When IS_DEMO blocks telemetry, the warning now says so and tells you how to fix it. (#1768)
  • Account moves survive a usage reset. (#1775)
  • Ingest repairs account keys that arrived joined by a tab. (#1776)
  • The review findings picker shows real checkboxes. (#1746)
  • rustix moves to 1.1.6 to fix the advisory RUSTSEC-2026-0486. (#1787)
  • playbook pr stack reads the starting PR while the stack API answers, which makes it faster. (#1740)

Under the hood

The plugin is smaller. Rule skills no longer load other skills, the git agent is gone, and several commands now call the playbook binary directly. New tests guard command and skill names, the size of each command and skill, and the skill call graph.

All changes

Breaking changes

  • plugin: /playbook:commit-and-push is now /playbook:commit. (#1750)
  • plugin: /playbook:quick-review and /playbook:deep-review are removed. Use /playbook:review --quick or --deep. (#1759)
  • size: The CLI drops --allow-large from playbook deliver and removes playbook segment resplit. playbook segment size loses --limit and stops printing over=, and the pre-flight JSON stops printing checks.size. Scripts that use any of these must change. (#1786)

Features

  • pbtop: add up to 8 panels to a tab and arrange them automatically (#1745)
  • pbtop: fold projection into the budget strip and add an hourly chart (#1749)
  • plugin: keep commit-and-push as a deprecated stub (#1752)
  • plugin: rename /playbook:create-pull-request to pr-create (#1751)
  • pbtop: put every chart on the first tab by default (#1753)
  • pbtop: redraw the Budget strip with bars, a pace marker and fewer words (#1754)
  • plugin: rename /playbook:address-pr-comments to pr-comments (#1755)
  • plugin: rename the handoff commands to handoff-save and show (#1763)
  • plugin: rename learn-project and repo-audit to learn and audit (#1767)
  • setup: repair missing or stale telemetry keys (#1769)
  • setup: remove IS_DEMO that blocks telemetry (#1770)
  • statusline: read the last main turn from a transcript tail (#1772)
  • statusline: estimate the next message cost and cache state (#1773)
  • statusline: show the next message estimate on line 3 (#1774)
  • usage: filter telemetry queries by account (#1778)
  • pbtop: scope every panel by the picked account (#1779)
  • usage: add --account to summary, json and pbtop (#1780)

Fixes

  • plugin: show real checkboxes in the review findings picker (#1746)
  • usage: keep account moves across a usage reset (#1775)
  • usage: repair tab-joined account keys on ingest (#1776)
  • telemetry: stop the false session warning and name IS_DEMO (#1768)

Performance

  • pr: read the start PR while the stack API answers in pr stack (#1740)

Other changes

  • docs: show code search and document reading in the README (#1742)
  • refactor(plugin): retire the git agent (#1743)
  • test(plugin): add a size budget for commands and skills (#1747)
  • test(cli): fix the macOS and load sensitive tests (#1748)
  • refactor(plugin): slim /playbook:pr-comments onto playbook pr comments (#1757)
  • docs(writing): never hard-wrap prose in markdown (#1758)
  • test(plugin): guard the skill call graph with a shrink-only list (#1760)
  • refactor(plugin): rule skills stop loading other skills (#1761)
  • refactor(plugin): slim handoff-save and handoff-show onto the binary (#1766)
  • test(usage): pin the token path at session start (#1777)
  • build(deps): bump rustix to 1.1.6 for RUSTSEC-2026-0486 (#1787)

Full changelog: v0.42.0...v0.43.0