Skip to content

Bean File Operations

beans_bean_file

Single tool with operation selector:

  • read
  • edit
  • create
  • delete
  • update_frontmatter

Path semantics

  • Paths are resolved under .beans/
  • Leading .beans/ is accepted and normalized
  • Path traversal outside workspace bean root is blocked

update_frontmatter

Atomic metadata update without rewriting body.

Supported fields:

  • title, status, type, priority
  • parent_id, tags
  • blocking_ids, blocked_by_ids
  • pr, branch

Nullable fields can be removed by setting them to null.

Frontmatter normalization

  • title is normalized to double-quoted YAML scalar
  • Inline comments and YAML quoting edge cases are handled

Released under the MIT License.