What is the Whiteboard?
The whiteboard is a persistent, session-scoped scratchpad that the AI agent uses to organize its work. Think of it as shared notes between you and the agent — a place to track plans, progress, and intermediate findings across multiple conversation turns.How It’s Used
The agent interacts with the whiteboard through two tools:| Tool | Description |
|---|---|
| read_whiteboard | Agent reads the current whiteboard content and metadata |
| write_whiteboard | Agent updates the whiteboard content |
Typical Uses
- Task planning — The agent outlines its approach before executing
- Progress tracking — Checkboxes and status updates as tasks are completed
- Intermediate findings — Notes and summaries during research or analysis
- Handoff notes — Context for continuing work in future sessions
Notifications
When the agent callswrite_whiteboard with notify_user: true, you’ll see a notification in the UI highlighting the update. The agent uses this flag when it has something important to share — like completing a major step or needing your input.