Beacons
Save and organize important messages, tasks, documents, and databases for quick access
Beacons let you save items for quick access later. You can beacon messages, tasks, documents, databases, and uploads — anything you want to find again without searching.
What You Can Beacon
| Item Type | How to Beacon |
|---|---|
| Messages | Hover over a message and click the beacon icon |
| Tasks | From the task context menu |
| Documents | From the document context menu |
| Databases | From the database context menu |
| Uploads | From the upload context menu |
Each item can only be beaconed once per user — beaconing the same item again has no effect.
Saving a Beacon
Messages
Hover over any message to reveal the action bar. Click the beacon icon to save it. This is useful for:
- Key decisions made in chat
- Important announcements
- Messages with links or resources you'll need later
- Agent responses you want to reference again
Tasks, Documents, and Databases
Right-click (or use the context menu) on any task, document, or database to find the beacon option.
Adding Notes
Every beacon can have an optional note — a short text reminder of why you saved it. Add a note when beaconing or edit it later from the beacons view.
Notes help you remember context:
- "Decision about API versioning approach"
- "Q2 metrics to include in board deck"
- "Agent's competitor analysis — good template"
Browsing Beacons
Access your beacons from the sidebar quick-access section or using Cmd+Shift+B (Ctrl+Shift+B).
Filtering by Type
The beacons view shows type counts at the top. Click a type to filter:
- All — Every beacon
- Tasks — Only beaconed tasks
- Documents — Only beaconed documents
- Messages — Only beaconed messages
- Databases — Only beaconed databases
- Uploads — Only beaconed uploads
Organization
Beacons are sorted by most recently saved. You can reorder them via drag-and-drop to create a custom priority order. The list shows the item title (or message preview), your note (if any), and when you saved it.
Removing Beacons
Single Removal
Click the remove button on any beacon to delete it. The original item is not affected — only your beacon is removed.
Bulk Removal
Select multiple beacons and use the bulk remove action to clean up several at once.
Automatic Cleanup
If a beaconed item is deleted (e.g., a message is removed or a task is cancelled and purged), the beacon is automatically cleaned up the next time you view your beacons.
Use Cases
Personal Dashboard
Beacon your most-used databases, key documents, and active task groups to create a personal quick-access list.
Decision Log
Beacon messages where important decisions were made. Add notes explaining the decision and its context. This creates a lightweight decision log without the overhead of a formal document.
Research Collection
When agents produce useful research, beacon the key messages. Later, compile them into a document:
@Writer review my beaconed messages from this week
and compile the research findings into a summary document
Meeting Prep
Before a meeting, beacon relevant tasks, documents, and messages. During the meeting, open your beacons for quick reference.
Tips
- Use notes liberally — A beacon without context is easy to forget. A one-line note makes it useful months later.
- Review periodically — Clear out beacons you no longer need to keep the list focused
- Beacon agent responses — Good agent outputs are worth saving as templates for future requests
- Combine with search — Use the command palette to find items, then beacon the ones you'll need again
- Drag to reorder — Arrange your beacons by priority using drag-and-drop for a personalized quick-access list