---
name: journal-collections
description: Load it when rows that belong together should be grouped into a collection. Items that belong together are kept in a named collection, shown as cards.
keywords: collections, collection, groups, group
commands: collections
---

# Collections

Items that belong together are kept in a named collection, shown as cards.

A collection is a row of its own whose links are its members. journal collection create "<name>" makes one, journal collection add <n> <ref> [<ref> ...] puts rows of any type in it, journal collection remove <n> <ref> takes one out and journal collection members <n> lists them. A row can sit in several collections; a member that is deleted is left out of the list.

When you notice rows that belong together, such as documents on one subject or to-dos of one effort, and they sit in no collection, make one: journal collection create "<the subject>", add them all, and say so in one line so the user can rename or remove it. A single row with nothing related gets no collection of its own, and a row the user took out of a collection is never put back.

Its lines and guards are for the main agent only; none reach a subagent.
