Skip to content

Releases

playbook 0.43.0

Choose a tag to compare

@github-actions github-actions released this 12 Nov 13:08
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...
Read more

playbook 0.42.0

Choose a tag to compare

@github-actions github-actions released this 09 Nov 18:00
ab5372a

Features

  • brief: add an optional code-facts block to Work Unit briefs (#1661)
  • doctor: show the stored schema versions of usage.db and config.db (#1663)
  • code-bench: add the end-to-end task draw and grader (#1665)
  • code-bench: run the end-to-end tasks and build the report (#1666)
  • code-bench: add the acceptance rule for the brief facts default (#1667)
  • code-bench: add the Claude CLI adapter and the weekly evaluation workflow (#1669)
  • usage: record the machine on every usage row (#1668)
  • pbtop: pick a machine with x and scope the panels (#1671)
  • usage: keep the machine id in usage.db (#1672)
  • usage: label each event by the account in effect at its time (#1674)
  • usage: limit an account move to one session (#1675)
  • pbsync: add the pbsync crate with an HTTP transport (#1677)
  • pbsync: define the usage table and create the remote schema (#1678)
  • pbsync: push usage rows with an allowlist and salted hashes (#1679)
  • usage: add the local tables and the all-machines view for sync (#1680)
  • pbsync: add the settings file and the enable and disable commands (#1682)
  • pbsync: pull usage rows from the other machines (#1681)
  • pbsync: add the push and pull commands (#1684)
  • doctor: show the sync state when sync is on (#1685)
  • config: classify which config keys may sync between machines (#1688)
  • update: install and update pbsync beside the playbook binary (#1686)
  • pbsync: add the purge command (#1687)
  • config: apply a synced config proposal after showing the diff (#1691)
  • pbsync: push and pull the shared config snapshot (#1689)
  • org: carry settings and state over from the old org name (#1697)
  • plugin: prefer the amplifiedengineer marketplace id (#1701)
  • commit: add a deterministic commit all command (#1702)
  • cli: run doctor check for a bare playbook doctor (#1704)
  • deliver: refuse merge commits and check commit type (#1707)
  • cli: add --json and --args-stdin to pr prepare (#1709)
  • sessions: add the sessions.db store (#1711)
  • pr: add pr finish-context (#1713)
  • plugin: install a missing plugin in sync when allowed (#1712)
  • plugin: turn on marketplace auto-update after install (#1716)
  • cli: add inline json mode to commit all (#1710)
  • cli: add rule ids and a branch guard to deliver (#1717)
  • cli: add pr land to wait for checks and merge a PR (#1719)
  • plugin: run commit-and-push as one inline call (#1714)
  • deliver: open pull requests in one deliver call (#1718)
  • setup: install and update the playbook plugin (#1720)
  • finish: drive the finish skill with finish-context and pr land (#1721)
  • plugin: point a behind or missing plugin at playbook setup (#1722)
  • cli: add playbook plugin update (#1724)
  • cli: add playbook plugin install and rename plugin update to plugin upgrade (#1726)
  • cli: make playbook upgrade the primary command and keep update as an alias (#1734)
  • telemetry: add six pbtop captures in dark and light with an image guard (#1736)

Fixes

  • install: use the renamed org and accept older release names (#1695)
  • org: try the next name when attestation times out (#1696)
  • plugin: find installs under renamed marketplaces (#1698)
  • cli: point messages and docs to playbook doctor check (#1703)
  • cli: refresh the marketplace before updating the plugin (#1705)
  • cli: check the plugin folder Claude Code loads when updating (#1706)
  • config: list usage.timeZone as a known config key (#1715)
  • deps: move rusqlite to 0.41.1 for the libsqlite3-sys advisory (#1727)

Performance

  • pr: run the independent gh calls of pr comments side by side (#1739)

Other changes

  • refactor(usage): make the machine id without the uuid crate (#1664)
  • docs(code-bench): add the code index evaluation page and its numbers test (#1670)
  • chore(org): move playbook to the amplifiedengineer org (#1692)
  • chore: point docs and metadata at the amplifiedengineer org (#1694)
  • docs: add a rename notice and fix drifted docs (#1699)
  • docs: point install and update to playbook@amplifiedengineer (#1700)
  • refactor(cli): nest pr finish-context as pr finish context (#1723)
  • refactor(cli): rename pr finish context to pr status (#1725)
  • refactor(telemetry): write one SVG line per row and take pictures from a shot list (#1728)
  • docs: cut the README to a 70 line budget and guard it in CI (#1729)
  • test(docs): fail when a guide names a command that does not exist (#1731)
  • docs: add a docs map, Get started and Concepts, and move the ADR table (#1732)
  • docs(recipes): add seven recipes and a runner that checks them (#1730)
  • test(cli): stop load-sensitive test failures (#1735)
  • docs: add a code search page and a token benchmark to the guide (#1733)
  • docs: add the full pbtop page with a generated key table (#1738)

Full changelog: v0.41.0...v0.42.0

playbook 0.41.0

Choose a tag to compare

@github-actions github-actions released this 07 Nov 00:54
b91d79c

Features

  • pbtop: add a usage reset key with a confirmation (#1600)
  • review: review each stacked PR alone with a digest above it (#1602)
  • handoff: write a handoff when /clear ends a session (#1606)
  • code-bench: add bench crate with metrics and dependency guard (#1624)
  • usage: add a stable machine id and name (#1626)
  • code-bench: add corpus manifest and fetcher (#1628)
  • code-bench: add process runner and universal-ctags adapter (#1635)
  • code-bench: add frozen task generator and task set v1 (#1637)
  • code-bench: add tuned rg candidates and baseline (#1638)
  • code-bench: add scip oracle adapter and audit sample rate (#1640)
  • code-bench: add pilot runner and report (#1641)
  • code-bench: add pilot command and runner integration test (#1642)
  • code-bench: add gate rules in basis points (#1643)
  • code-bench: add gate cases and the merge-base data check (#1644)
  • code-bench: add baseline, floor and override data files (#1645)
  • code: bind refs to the declaring module when a name repeats (#1653)
  • code: guard the parse with a tick budget and a nesting cap (#1654)
  • store: refuse a newer usage and config database schema (#1656)
  • code: skip generated files when indexing (#1657)
  • code: store the language list of each worktree at index time (#1658)

Fixes

  • update: stop pointing at the retired apt and dnf packages (#1609)
  • pbtop: keep a model's colour the same across ranges and charts (#1619)
  • code: accept go in the --lang filter of search and symbol (#1621)
  • common: keep a child's unread stdin from killing the hook (#1627)

Other changes

  • refactor(agents): spawn the base agent with an effort parameter (#1612)
  • refactor(agents): remove the per-session agent variants (#1615)
  • docs(telemetry): drop text about the retired playbook-telemetry command (#1620)
  • refactor(store): add the playbook-store crate over rusqlite (#1623)
  • test(code): add hand-labeled fixtures and conformance tests (#1625)
  • refactor(store): move common and data onto playbook-store (#1629)
  • test(cli): add per-language acceptance tests for code commands (#1632)
  • test(code): add insta snapshots of extracted symbols per language (#1630)
  • test(code): add fuzz targets and file-system edge tests (#1631)
  • refactor(store): move telemetry onto playbook-store (#1633)
  • test(cli): stop three tests from reading the host machine (#1634)
  • refactor(store): move the code index onto playbook-store (#1636)
  • refactor(store): move the cli onto playbook-store (#1639)
  • test(code): add metamorphic and equivalence tests on the fixtures (#1647)
  • ci(code-bench): add the nightly benchmark workflow (#1648)
  • ci(code-bench): add the mutation workflow and score floor (#1650)
  • test(code-bench): run the gate on the committed fixtures in nextest (#1652)
  • test(code-bench): read the workflow by line and drop serde_norway (#1651)
  • ci(code-bench): add the fuzz workflow (#1655)

Full changelog: v0.40.2...v0.41.0

playbook 0.40.2

Choose a tag to compare

@github-actions github-actions released this 06 Nov 12:26
v0.40.2
c60c951

Features

  • pbtop: move with h and l and scroll the help with j and k
  • pbtop: switch between local time and UTC with z
  • doctor: warn when the Claude Code token is not the collector's
  • pbtop: set the manual monthly budget from a window
  • pbtop: show the manual and the detected monthly budget together
  • telemetry: sync Claude Code keys on config set
  • pbtop: detect Enterprise and hide the 5 hour and weekly windows
  • pbtop: join the burn-up lines into unbroken strokes
  • pbtop: color the burnup usage by an HSV gradient
  • pbtop: add an opt-in spectrum theme
  • statusline: show local spend against a monthly budget (#1586)
  • usage: add account list and display names
  • usage: move events between accounts and undo the move
  • routing: default routing.escalate to auto (#1595)
  • usage: list sessions and move events by session boundary
  • usage: compare session boundaries with a dashboard
  • telemetry: show one merged Tools table with a transcript marker (#1575)
  • hooks: warn at session start when the telemetry keys are missing (#1576)
  • pbtop: link pbtop to playbook and warn on an older pbtop (#1588)
  • usage: label each session by the credential it used (#1581)
  • pbtop: pick the account with u and show it in the title (#1582)
  • usage: run the account commands on a copy of the database
  • effort: return the Agent tool effort from effort resolve (#1596)
  • plugin: hide helper skills from the slash menu (#1597)
  • review: pick findings and comments from a checklist (#1599)
  • nix: move the Nix flake to pragmatic-engineer/nix (#1603)

Fixes

  • telemetry: name custom agents from transcripts
  • pbtop: keep the stale reported amount in the monthly budget bar (#1601)
  • handoff: stop key collisions and keep the file on a failed archive (#1598)

Other changes

  • ci(auto-update): update armed PRs one at a time (#1590)
  • chore(release): drop the AUR, apt and dnf, scoop and winget channels (#1604)

Full changelog: v0.40.1...v0.40.2

playbook 0.40.1

Choose a tag to compare

@github-actions github-actions released this 06 Nov 04:17
4cb1b32

Features

  • doctor: warn on worktree shell refusal in Claude Code 2.1.318 (#1553)
  • prose: warn on passive voice and check text against facts (#1554)
  • agents: add writer agent that drafts text from facts (#1565)

Fixes

  • prompt: recover when Bash is refused in a worktree (#1555)
  • update: refresh the placed system prompt after a plugin update (#1561)

Other changes

  • test(telemetry): bound the ignored-holder wait by the stop budget plus slack (#1548)
  • docs(writing-style): add length limits and ban passive voice (#1552)
  • docs(agents): isolate shell agents once a session enters a worktree (#1559)

Full changelog: v0.40.0...v0.40.1

playbook 0.40.0

Choose a tag to compare

@github-actions github-actions released this 05 Nov 06:09
1e5e9c7

Breaking changes

  • data: the code index now lives in one shared store per repo, so after upgrading delete the old per-worktree index files at ~/.config/playbook/data/code/<owner>/<repo>/<worktree-id>.db (playbook setup also removes them). They are a cache, and the next playbook code index rebuilds into store-v<N>.sqlite3. (#1526)

Features

  • code: rank core declarations above tests and docs in context (#1302)
  • release: AUR package template and renderer (#1306)
  • release: scoop manifest template and renderer (#1311)
  • code: index Go files with the tree-sitter-go grammar (#1305)
  • cli: print help when a required argument is missing (#1317)
  • cli: group root help into user and agent commands (#1318)
  • cli: add playbook completions for bash, zsh and fish (#1319)
  • cli: add completion stub writer for bash, zsh and fish (#1324)
  • cli: report and remove shell completions in doctor and uninstall (#1331)
  • cli: snapshot flag attributes to verify help rewrites (#1334)
  • cli: install shell completions during setup (#1335)
  • config: add the sessions.autoClose key (#1366)
  • hooks: record turn and waiting state per session (#1371)
  • sessions: add a dry run sweep for finished sessions (#1375)
  • plugin: route code questions through playbook code (#1377)
  • handoff: load the saved handoff after /compact (#1391)
  • code: add parser key and extractor digest test (#1397)
  • code: write worktree, content and manifest rows beside files (#1398)
  • system-prompt: add autonomy rule for failures (#1409)
  • config: add gate.maxRounds for the gate loops (#1429)
  • statusline: add a budget line for the 7 day and 5 hour caps (#1417)
  • telemetry: rework pbtop with an accessible palette, row layouts and a map editor (#1473)
  • gc: add playbook gc with tombstones, guarded sweeps and build output cleanup (#1475)
  • memory: recall candidates from an FTS5 index over fact bodies (#1517)
  • review: make the review stack aware (#1413)
  • worktree: clone the main target folder into new worktrees and report it in doctor (#1447)
  • code: index every worktree of a repo into one shared store (#1479)
  • setup: register the Bash guards in Codex and report them in doctor (#1449)
  • usage: decide the monthly dollar figure and explain it in doctor (#1520)
  • statusline: show the monthly dollar figure on line 4 (#1523)
  • watch: add watch mode for GitHub events (#1516)
  • pbtop: tag local spend as this machine, show Claude's report (#1524)

Fixes

  • windows: run on an 8 MiB stack thread (#1309)
  • telemetry: prefer a detected monthly limit over the manual budget (#1328)
  • code: make the context token budget cover the whole text output (#1308)
  • cli: keep the zsh loader silent when compinit fails (#1360)
  • doc: report the same memory reason from both watchdogs (#1373)
  • usage: keep the newest plan limit reading across sessions (#1376)
  • telemetry: say used is this machine only when stale (#1394)
  • handoff: keep the handoff file when the move to used/ fails (#1396)
  • worktree: let the sweep read the pull request state of a branch
  • unblock main by fixing the help example and adding ADR 0057 (#1455)
  • worktree: keep open PR worktrees, count only default branch merges (#1444)
  • config: list the dotted view words in the usage.ui.layout error (#1518)
  • watch: audit a stale event once (#1530)
  • config: accept fractional dollars for watch.limits.usdPerDay (#1522)

Performance

  • config: read a ready settings store without the full open (#1367)
  • code: stop allocating per word and per line in index and search (#1369)

Other changes

  • ci(shell): add a CI job for the shell completion tests (#1320)
  • test(cli): replace the commands golden with a structural test (#1322)
  • refactor(usage): rename the dashboard title to Agent Budget Dashboard (#1329)
  • test(cli): lint command help against allowlists that only shrink (#1332)
  • refactor(plugin): merge the cli skill into playbook-usage (#1330)
  • docs(cli): add a style guide for command help text (#1339)
  • refactor(cli): wire zsh completion through a loader file (#1341)
  • refactor(test): drop dead_code allows from hook and parity test support (#1352)
  • test(cli): split shared test helpers into smaller modules (#1351)
  • refactor: share duplicate helpers across the crates (#1359)
  • refactor: share duplicate helpers inside code and telemetry (#1361)
  • docs(config): mark launcher.claudeOverride retired and date the retired flags (#1355)
  • refactor(init): rename shim.rs to rcfile.rs and date the launcher cleanup (#1357)
  • refactor(pbdoc): narrow pub items to pub(crate) (#1343)
  • refactor(cli): narrow update and auto cost items to pub(crate) (#1348)
  • build(deps): remove unused ratatui dependency (#1342)
  • refactor(telemetry): narrow tz helpers to pub(crate) (#1344)
  • refactor(code): narrow testkit and walker items to pub(crate) (#1345)
  • refactor(cli): narrow test support items to pub(crate) (#1349)
  • refactor(cli): narrow statusline items to pub(crate) (#1346)
  • refactor: remove redundant clones and by-value arguments (#1358)
  • refactor: remove dead code and gate test-only helpers (#1353)
  • test(cli): stop the collector daemon tests from failing under load (#1362)
  • refactor(init): remove the no-op shell-init-rc-line migration (#1354)
  • ci(windows): fail the Windows check on warnings (#1356)
  • refactor(cli): narrow commit message sanitizer items to pub(crate) (#1347)
  • bui...
Read more

playbook 0.39.0

Choose a tag to compare

@github-actions github-actions released this 21 Oct 22:02
930bb99

Breaking changes

  • hooks: cut the rm guard down to rm of / or the home folder (#1202)
  • hooks: remove the disk-guard hook (#1230)
  • setup: remove the disk-ballast part and the disk doctor rows (#1245)
  • disk: remove the playbook disk command (#1246)
  • config: remove the disk config keys and ADR 0047 (#1249)

Features

  • disk: remove a worktree's cargo target folder with it (#1181)
  • update: update the playbook plugin from update and migrate (#1182)
  • setup: offer the disk ballast as an opt-in part (#1186)
  • prompt: require a memory search before claiming no knowledge (#1191)
  • telemetry: add writer thread with lifetime lock (#1190)
  • hooks: hint when memory recall finds nothing or only weak matches (#1194)
  • update: add the ask and auto modes to update.plugin (#1192)
  • skills: add the skills sync planner and renderer for Codex (#1196)
  • telemetry: serve with a thread per connection and shutdown (#1197)
  • hooks: recall memory facts by crate name and alias (#1198)
  • telemetry: add daemon ensure and stop for the collector (#1208)
  • telemetry: add playbook usage stop (#1212)
  • telemetry: start the collector daemon from hooks and commands (#1215)
  • doctor: show who holds the collector daemon lock (#1216)
  • skills: add playbook skills sync for Codex (#1200)
  • update: update the plugin at the first command after an upgrade (#1199)
  • update: start the plugin update from the session hook (#1209)
  • skills: refresh synced skills when playbook is upgraded (#1213)
  • hooks: make the policy guard optional and off by default (#1195)
  • migrate: remove the collector service on upgrade (#1217)
  • setup: retire the collector-service part (#1218)
  • usage: compare reported spend with local cost (#1227)
  • usage: model the lines the usage sources carry (#1228)
  • usage: show crossings and why a limit is missing (#1229)
  • usage: add the burn-up series for any limit (#1236)
  • usage: burn-up panel from reported limits (#1237)
  • usage: mark HTTP 429 replies on the burn-up chart (#1262)
  • release: support cargo binstall and mise (#1261)
  • usage: keep a bounded history of window readings (#1263)
  • usage: add a format version to each rate limit history line (#1265)
  • nix: add flake with release binaries and hash renderer (#1275)
  • pbdoc: add the pbdoc helper crate with its CLI contract (#1291)
  • pbdoc: enforce hard limits in the helper (#1292)
  • pbdoc: guard the dependency closure and its notices (#1293)
  • doc: prefer the bundled converter and refuse oversized files (#1294)
  • doc: serve long conversions in bounded slices (#1295)
  • install: build, attest and install the pbdoc helper (#1296)
  • update: swap and remove the pbdoc helper on update and uninstall (#1297)

Fixes

  • prompt: do not require task tools that many builds lack (#1221)
  • hooks: log real compactions with session and context size (#1250)
  • git: check the worktree and branch first in commit and PR skills (#1253)
  • drop retired rm guard rules and keep foreign service files (#1255)
  • update: recognise .deb and .rpm installs in /usr/bin (#1266)
  • statusline: honor the auto-compact window in the compaction gap (#1268)

Performance

  • usage: cache rate limit history by file mtime and size (#1270)

Other changes

  • chore(deps): bump sha2 from 0.10.9 to 0.11.0 (#1187)
  • test(hooks): replay 11 prompts against the memory recall bars (#1210)
  • test(hooks): drop the rm guard roots and corpus integration tests (#1201)
  • test(cli): pin collector port in setup_alias tests (#1222)
  • docs(hooks): describe the short rm guard rule (#1203)
  • refactor(hooks): remove the no-slop-guard hook (#1193)
  • test(hooks): drop the rm guard corpus fixture (#1204)
  • refactor(hooks): remove the old rm guard module and helpers (#1205)
  • refactor(disk): remove the cleanup and ballast code (#1247)
  • refactor(disk): remove targets, backups and the classifier (#1248)
  • refactor(hooks): remove the first part of the rm guard parser (#1206)
  • refactor: prune collector service setup and move account functions (#1219)
  • refactor(hooks): remove the rest of the rm guard parser (#1207)
  • refactor(service): prune the service manager to its removal paths (#1220)
  • docs(commands): add compact and clear checkpoints to plan and implement (#1251)
  • docs: document collector daemon and retire service setup (#1225)
  • test: fix zone leak, flaky self-heal test and real HOME writes (#1254)
  • docs(adr): close the ADR number gaps and pin the sequence (#1257)
  • test(hooks): run guard tests in scratch home, fail on HOME use (#1269)
  • refactor(plugin): move worktree guard to delegating-subagents (#1267)
  • test(hooks): run the Bash guards against Codex-shaped payloads (#1274)
  • docs: fix the agent count and add tap trust to the pbtop README (#1283)
  • docs(doc): describe the bundled converter (#1298)
  • refactor(doc): route every converter lookup through one facade (#1299)

Full changelog: v0.38.0...v0.39.0

playbook 0.38.0

Choose a tag to compare

@github-actions github-actions released this 19 Oct 02:39
d93dc81

Breaking changes

  • cli: the playbook shell-init command is removed. Start sessions with pb cc or pb ccd, and delete the eval "$(playbook shell-init)" line from your shell rc file, or run playbook setup to remove it after a backup. Until 1.0 the old line prints one notice on stderr and the shell still starts. (#1152)

Features

  • shell: mark commands that meet a command substitution (#1127)
  • hooks: add a command parser for the rm guard (#1126)
  • hooks: list the rm guard's built-in roots per OS (#1131)
  • hooks: judge rm targets against the built-in roots (#1132)
  • hooks: follow cd in the rm guard (#1139)
  • hooks: follow variables in the rm guard (#1140)
  • hooks: add a built-in deny set to the rm guard (#1142)
  • disk: add the free space probe and disk.* config keys (#1141)
  • hooks: judge more deletion commands in the rm guard (#1151)
  • hooks: run the rm guard for every Bash command (#1154)
  • migrate: attach each migration to its release version (#1137)
  • disk: add disk status and a doctor row (#1153)
  • disk: add disk clean (#1155)
  • disk: add disk reserve and disk release (#1156)
  • disk: list cargo target folders of any project in disk status (#1158)
  • migrate: name migrations by slug and convert old records (#1157)
  • disk: classify which Bash commands are builds (#1166)
  • disk: add the disk-guard hook that stops builds on a full disk (#1162)
  • setup: rename attribution-off to attribution with ON and OFF (#1163)
  • memory: add memory stats and print it after a rebuild (#1169)
  • disk: wire the disk guard into setup, the session and status line (#1167)
  • cli: add playbook commands, a list built from the clap tree (#1173)
  • setup: retire the attribution-off migration and add flag aliases (#1171)
  • disk: clean up old migration backups and stop making more (#1170)
  • hooks: add playbook hooks explain-rm to show rm guard verdicts (#1176)
  • migrate: list each item that needs you with its fix (#1175)
  • plugin: add the playbook:cli skill pointing to playbook commands (#1177)

Fixes

  • release: keep full multi-line breaking change footers (#1125)
  • hooks: let the policy guard allow reads of the config store (#1129)
  • hooks: judge rm guard targets from real command words (#1128)
  • setup: name the collector agent com.github.pragmatic-engineer (#1134)
  • migrate: move the collector agent to its new label (#1136)
  • rm-guard: allow playbook's folders, protect only irreplaceable data (#1165)
  • policy-guard: allow store reads, leave deletions to the rm guard (#1172)
  • migrate: show each pending item once, then once a day (#1179)

Other changes

  • test: give every playbook test a scratch home (#1130)
  • docs: add the rm guard guide and ADR 0045 (#1133)
  • test(hooks): pin the rm guard's verdicts on a corpus of real commands (#1138)
  • docs: describe migrations by slug and release version (#1160)
  • refactor(settings): make settings.shared.json the one permissions source (#1161)
  • refactor(setup): look for the seed in the seed folder of a checkout (#1164)
  • docs(memory): point shipped text at data/memory.db and guard it (#1174)
  • refactor: move the shipped seed to seed/ and intents.json to plugins/ (#1168)
  • refactor: remove breaking-changes.json and playbook breaking (#1178)
  • chore(dev): tidy the justfile, the seed Brewfile and the script tests (#1180)
  • docs: move pages into guides, reference and internals (#1183)

Full changelog: v0.37.0...v0.38.0

playbook 0.37.0

Choose a tag to compare

@github-actions github-actions released this 18 Oct 00:07
260abda

Upgrade note

If you installed the hooks as the playbook-hooks plugin, run this once after you upgrade:

claude plugin uninstall playbook-hooks@pragmatic-engineer
playbook setup --yes

The hooks now live in ~/.claude/settings.json. playbook setup adds them, and asks first when you run it in a terminal. On playbook 0.34 or earlier, the command is playbook init --yes.

Since 0.34.0 the binary and the plugin share one version. The binary went from 0.26 to 0.34.0, so binary versions 0.27 to 0.33 do not exist. Those numbers were plugin releases.

Breaking changes

  • setup: `playbook setup --aliases` and `--claude-override` do (#1119)
  • cc: the playbook, claude and pb shell functions are gone. (#1120)
  • setup: `setup --yes` now installs the system prompt and links (#1122)

Features

  • setup: link pb from the short-name part (#1118)
  • setup: remove the retired launcher rc line with consent (#1121)

Other changes

  • docs: describe pb cc without the shell launcher (#1123)

Full changelog: v0.36.0...v0.37.0

playbook 0.36.0

Choose a tag to compare

@github-actions github-actions released this 17 Oct 01:12
654a02d

Upgrade note

If you installed the hooks as the playbook-hooks plugin, run this once after you upgrade:

claude plugin uninstall playbook-hooks@pragmatic-engineer
playbook setup --yes

The hooks now live in ~/.claude/settings.json. playbook setup adds them, and asks first when you run it in a terminal. On playbook 0.34 or earlier, the command is playbook init --yes.

Since 0.34.0 the binary and the plugin share one version. The binary went from 0.26 to 0.34.0, so binary versions 0.27 to 0.33 do not exist. Those numbers were plugin releases.

Features

  • setup: turn off Claude Code attribution with consent (#1101)
  • usage: add a launchd and systemd service for the collector (#1104)
  • cli: install, start and remove the collector service (#1108)
  • setup: keep the usage collector running in the background (#1105)
  • migrate: remind existing installs once about the collector service (#1107)

Fixes

  • eval: find agent files under plugins/playbook (#1096)
  • ci: run the repo checks on the plugins/playbook layout (#1095)
  • cc: clear inherited agent variants before a launch (#1102)
  • pbtop: say why a telemetry view is empty and how to fix it (#1106)
  • auto: raise the default spend caps to measured session cost (#1115)

Other changes

  • chore(cli): remove code nothing calls (#1092)
  • docs: list every ADR in the index and fix stale names (#1097)
  • build(toolchain): pin Rust 1.99.1 (#1098)
  • chore(deps): bump patch versions and refresh the lockfile (#1094)
  • chore(settings): use current tool names in the shared allowlist (#1099)
  • test(memory): read the touched time the staleness check reads (#1090)
  • docs(plugin): stop telling agents to call TaskOutput (#1100)
  • chore: fix gaps a review found in the sweep PRs (#1103)
  • test: stop waiting out the migrate lock budget (#1109)

Full changelog: v0.35.0...v0.36.0