Install Patchloom

About Patchloom

Patchloom is a single-binary CLI that gives AI coding agents safe, structured file editing: search and replace, unified diffs, parser-backed JSON/YAML/TOML document ops, markdown section editing, AST-aware renames, multi-file transactions, undo, and an MCP server for tool calls.

What's new in 0.27.0

Patchloom 0.27.0 Clearer agent recovery after failed writes, and machine-stable hints when a doc write selector uses a predicate or wildcard. Highlights Library hosts can read a backup session id from a failed apply path so fail-restore and undo do not scrape English error text. When doc set, doc ensure, or doc delete is called with a predicate or wildcard selector, JSON output can include suggested_op (doc.update or doc.delete_where) so harnesses can retry the right multi-match op without parsing messages. That mapping also holds when the predicate is an intermediate parent path, not only a leaf segment. New features - api::backup_session_from_error. On a failed write after a backup was created (for example a post-write --format failure), hosts can peel the session id from the error for fail-restore. Success paths already expose EditResult.backup_session; the Err path is now first-class. (#2129, #2131) - suggested_op on fail-closed write navigation. Predicate or wildcard selectors on single-path doc writes stay error_kind: invalid_input and may set suggested_op to doc.update (set/ensure) or doc.delete_where (delete). Plan/tx and MCP JSON preserve the field. Move has no multi-match sibling and omits the field. Intermediate parents use the same mapping as leaves. (#2136, #2137, #2140) Bug fixes - Tx JSON could drop suggested_op after re-wrap. Fail-closed predicate navigation still surfaces the hint on CLI and library peels after plan error packaging. (#2137) - Intermediate predicate always suggested doc.update. A delete (or move) path such as items[id=a].val no longer invent...

Read release notes

Version history