All documentation

Documentation Settings: The room

Prompt Library: editing and new-discussion suggestions

The prompt editor, your own categories, comparing a copy with its original, and what an empty discussion suggests.

The editor

Where to find it. Any app: Prompt Library → + New prompt, or Edit on a card. The editor replaces the library until you leave it. At the top: ← Back to library, a save state (No unsaved changes, Unsaved changes, Saving…, Saved) and "Synced across your devices".

FieldWhat goes in it
NameUp to 80 characters
CategoryA built-in category, Your prompts, or one of your own
Short descriptionUp to 240 characters, shown on the card
GoalThe outcome everyone works toward. Values in angle brackets are filled in before a run
Inputs the run needsOne field per angle-bracket value in the prompt. Shown only when there are any
Builder instructionsSteps for the seat doing the work, one per line, up to 12
Reviewer checksWhat the other seats must verify, one per line, up to 8
BoundariesWhat the prompt tells the seats to avoid, up to 8. Workspace guardrails are enforced separately
Expected outputWhat the run hands back at the end

A value in angle brackets can carry a default or a hint after a dash, for example a branch name with "default: main". A count at the foot shows the prompt's length. Past 4,000 characters it can still be used now but cannot be scheduled.

How to use it.

  1. Fill in the fields. Numbering or bullets you type at the start of a line are taken off.
  2. Press Save prompt. "Changes apply to future runs": a discussion already started keeps the words it was sent.
  3. Cancel or Back to library with unsaved changes asks before throwing them away.

Editing a ready-made prompt or a starting point saves a copy under Your prompts, based on the original. The ready-made one is left as it was. On a copy, Show original opens the original, and Compare with original lists each part as changed or the same.

Settings → The room → Prompt Library on the Mac, the editor open on a new prompt with Goal and Builder instructions filled in
Settings → The room → Prompt Library on the Mac, the editor open on a new prompt with Goal and Builder instructions filled in

Your own categories

+ Category among the chips asks for a name and makes a category kept with your account. Select one of your own and Rename and Delete appear beside it. Deleting a category moves its prompts back to Your prompts; nothing is deleted with it. To file a prompt, use Move to in its ⋯ menu.

New discussion preferences

The card under the grid, always open. Both settings are shared by the Mac, the web and the iPhone.

SettingDefaultWhat it doesChange it when
Suggestions on an empty discussionFour at random from hereWhat a new, empty discussion offers: four prompts drawn from this library with a link to all of them, The four fixed starters, or NoneYou want the same starters every time, or a blank page
"Use now" fills the discussion you're inOnUse now puts the prompt in the composer of the discussion in front, below what you typed; its folder and seats stay. Off starts a new discussion every timeYou often press Use now while in the middle of something else

The iPhone offers the suggestions setting but does not draw suggestion cards: an empty discussion there shows a link to the Prompt Library instead.

Settings → The room → Prompt Library on the Mac, the New discussion preferences card under the grid
Settings → The room → Prompt Library on the Mac, the New discussion preferences card under the grid

Further reading. A Systematic Survey of Prompt Engineering in Large Language Models — Sahoo et al., 2024.

See also

Not what you were looking for? The help centre answers one question at a time, and the support page says how to reach a person.