Bee Box documentation · directory: https://beebox.run/docs/reference/cards/ · index: https://beebox.run/docs/reference/cards/index.md · root: https://beebox.run/llms.txt

# tab-arrangement Card

# Tab Arrangement Cards

A tab arrangement card is a captured browser snapshot sent by Bee Box Clerk.
Help the boxholder reorganize it by editing only the `proposal` and explanatory
body. Preserve every source tab UUID: each UUID must appear exactly once
in one proposed window's ordered `tabs` list. Mark tabs to delete by also adding
their UUIDs to `close`; keep those UUIDs in their proposed window and roughly in
place so the boxholder can review them in context. Never replace a UUID with a
URL. Existing source window UUIDs preserve those windows; a new UUID creates a
new window. Keep pinned tabs before unpinned tabs in each window, and leave at
least one tab open.

Set `status: ready` only when the boxholder agrees the proposal is ready to
apply. Applying is always a separate, explicit action in the card viewer. Clerk
will refuse the whole change before mutation if the live tabs no longer exactly
match the captured snapshot. Do not edit `transfer-id`, `scope`,
`captured-at`, or `source`.


## The `contains:` field

Give this card a one-sentence `contains:` — the prime retrieval field for
`bbx search` and listings. How to write a good one (carry the information when
it's concise, never a list of parts, under 200 characters) is in the agent
guide's ABOUT_CARDS section.