edit-bookmarks

name	edit-bookmarks
description	Edit a team bookmarks YAML file — add, remove, rename or reorder links and folders.
license	MIT

Edit the team bookmarks YAML file based on the user's request.

Schema

name: string # collection name
folders: # root-level folders (folders only, no links at root)
  - name: string
    children: # ordered list of links and sub-folders (freely interleaved)
      - label: string # link: display name
        url: string # link: full URL
      - name: string # sub-folder
        children: [] # recursive, same structure

Discriminant: a child with label is a link; a child with name is a folder.

Steps

1. Find the bookmarks file in the current directory. It is usually named bookmarks.yml but may be any .yml or .yaml file whose root keys are name and folders.
2. Read the file carefully, including the comment header at the top.
3. Apply the requested change.
4. Preserve the comment header block exactly.
5. Write the updated file.
6. Confirm what changed (item name, action, location).

Supported operations

• Add a link: append { label, url } to the children of the most relevant folder. Ask if ambiguous.
• Add a folder: append { name, children: [] } inside the target parent's children, or at root level under folders.
• Remove a link or folder: delete the entry from children (or from folders for root folders).
• Rename: update the name (folder) or label (link) field.
• Reorder: move an item to a new position within its children array. Links and folders share the same list and can be freely interleaved.

Rules

• Never remove or alter the comment header block (lines starting with # at the top of the file).
• Preserve 2-space indentation and the existing lineWidth style.
• URLs must start with https:// unless the user provides a different scheme.
• Do not touch any other file in the repository.