Skip to main content
Pins let you surface the most important context in a Space so your agents always have it available. Think of a pin as telling your agents: “This is always relevant here.”

What you can pin

  • A message or thread from chat
  • A document or note
  • A key excerpt or decision
  • An artifact created by an agent
Anything pinned in a Space is part of the standing context your agents work from in that Space.

How to pin something

From chat: Hover over any message and click the Pin icon. Select the Space to pin it to (usually the current one). From a document: Open the document, click the menu, and choose Pin to Space. From an artifact: Open the artifact, then use the Pin option from the artifact menu.

Why pins matter

Agents read from what’s in the Space: threads, docs, and connected tools. Pins are how you make sure the most critical context is always at the top of that pile. Good things to pin:
  • The project brief or one-pager
  • Key decisions that shouldn’t be re-litigated
  • The current source-of-truth doc for a running project
  • Instructions specific to this Space (e.g. “Always use this tone for Acme Corp”)

Managing pins

View all pins in a Space from the Pins tab in the Space sidebar. To remove a pin, open the Pins tab, hover over the pin, and click Remove.
Removing a pin doesn’t delete the original content. It just removes it from the standing context your agents read from.

Tips

Pin the brief when you create a Space. Your agents will work from it immediately, without any additional prompting from your team.
  • Keep pins focused. A Space with 50 pinned items has noise, not context.
  • Update pins when a doc becomes outdated. Stale pins can mislead your agents.
  • Use pins for persistent instructions, things like tone, format preferences, or standing constraints for this Space.