Notes

A note pane is a TipTap-backed markdown editor on the canvas — a place to capture context, draft a spec, or sketch a diagram next to the agents that need it.

What you get

Each note pane is a TipTap editor configured with starter-kit, the markdown extension, and a placeholder — so it reads and writes plain markdown. Common features:

• Standard markdown — headings, lists, code blocks, links.
• Inline Mermaid diagrams — fenced ```mermaid blocks render live inside the note.
• Whisper dictation — toggle the mic on the pane header to dictate into the note.

Spawn one with Cmd+8Ctrl+8, or from the spawn menu.

Dictation

The note's dictation action records audio, transcribes it through Whisper, and writes the result back into the note. The Anthropic-powered polish path can clean the dictated text after the fact so a long verbal brain-dump becomes structured prose.

Use it for capturing ideas while you're walking, or for narrating a feature spec to a Claude pane sitting next to the note.

Inline Mermaid

Drop a fenced Mermaid block into a note and it renders inline:

```mermaid
flowchart LR
  Builder --> QA
  QA -->|needs changes| Builder
  QA -->|ship it| Validator
```

The diagram updates as you edit the source. This is the same Mermaid you'd use in GitHub, GitLab, or any markdown surface — flowcharts, sequence diagrams, state diagrams.

Have an agent drop a note onto the canvas

There's a convention every workspace's CLAUDE.md ships with: writing a markdown file into <projectDir>/.agent-grid/notes-inbox/ creates a note pane on the canvas. The filename becomes the note's title, and the source file is deleted after ingestion.

echo "# Sprint planning" > .agent-grid/notes-inbox/sprint-planning.md

Agent Grid polls the inbox roughly every two seconds, so within a moment the file becomes a note pane and the inbox is empty again. This is how Claude masters drop summaries, plans, or meeting notes onto the canvas without you copy-pasting.

See The .agent-grid/ folder for the rest of the project-local conventions (.agent-grid/notes/, roles.json, qa-specs/).

Related

• The .agent-grid/ folder — every project-local convention in one place.
• Voice mode — separate from note dictation; this is for live conversations with a Claude pane.
• Orchestrating agents — masters often drop summary notes into the inbox after long runs.