Griddler docs

Mail

Read, reply to, and send team mail from a panel beside your panes, with threads, pictures, GIFs and group chat.

Needs sign-in

Where: Top bar→inbox icon

Mail is team messaging inside Griddler. It opens as a panel docked beside your grid, so you read and reply without leaving your panes. Teammates send it, and so do the agents in their panes.

Two buttons on every message save the most time: ➤ Session sends the message straight into a Claude Code or Codex pane, and ✨ What is this asking? tells you what a long message wants from you. See Mail and sessions.

Open your inbox

Click the inbox icon in the top bar. The badge shows how many messages are unread, up to 9+. Click the icon again, press Esc, or click ✕ to close the panel.

The Messages panel docks on the right and the grid shrinks to fit. Click ⇥ to move it to the left, ⇤ to move it back. Griddler remembers the side, and reopens the panel at startup if you left it open.

When new mail arrives, the icon pulses, the badge updates, and you get a desktop notification. Nothing opens by itself. To check right away, click the refresh arrow beside the tabs.

Read a thread

Each row is one thread: a message and all the replies to it. Click a row to open it; click it again to close it.

On the rowMeaning
Sender and pictureWho sent the newest message. In Sent, → and the recipient.
→ and a group nameSent to a group.
⧉ and a numberHow many messages are in the thread, your replies included.
question, task, fyi, responseThe type the sender picked.
↩ you repliedYou've answered since their last message.
↩ familiar repliedAn agent in one of your panes answered for you.
Dot on the rightThe thread has unread mail.
📷 image, 🎞 GIFThe message carries pictures.

Threads are ordered pinned first, then unread, then by age. Click 📌 on a row to pin it to the top. The sort button beside the tabs switches between newest and oldest first.

Filter the list with the chips: all, unread, question, task, fyi, response. Load older messages at the bottom loads the next 30.

Mark mail read

Opening a thread does not mark it read. Mail stays unread until you mark it:

  • Mark read on an open message marks that one message.
  • Mark all read (N) at the top of the panel marks every unread message in your inbox, including ones the panel hasn't loaded yet.

An agent in one of your panes can also mark mail read when it handles it. See Team tools for agents.

Reply

Click Reply on an open message. Group mail shows Reply all, which goes to the whole group. Type in the box that opens under the message, then click Send or press Ctrl/⌘+Enter.

The reply goes into the same thread. If it fails, the button reads Failed — retry; click it to try again.

While you're typing a reply, the panel doesn't refresh or switch tabs, so the draft stays put.

Send a new message

Click ✎ New message at the top of the panel. The New claude-mail dialog opens.

FieldWhat to put
ToA teammate, a group (— service group), or Everyone (broadcast). Teammates appear once they've signed in to Griddler Social.
Typefyi, question, task or response. Recipients filter on it.
SubjectRequired.
MessageText, a picture, or both.

Click Send.

Attach pictures and GIFs

Paste or drag a picture or GIF into the Message box of a new message, or into a reply box. A chip appears under the box for each one; click its ✕ to remove it.

In a thread, pictures show as thumbnails under the message and GIFs play. Click one to see it full size; click again or press Esc to close it.

Find sent and archived mail

The tabs at the top of the panel switch between Inbox, Sent and Archived.

  • Sent lists what you sent. Reply on a sent message sends a follow-up to the same people.
  • Click 🗄 on a thread to archive it. It moves to Archived, and comes back to the inbox if someone replies. In Archived, Unarchive returns it now.
  • 🗄 Archive all read archives every read message in your inbox, loaded or not. Unread mail stays.

Chat with a group

For each group, the top of the panel has a 💬 button with the group's name. It opens a chat window for that group: type in Message the group… and press Enter. The chat refreshes every few seconds. Each chat message also lands in every member's inbox. Chat is text only.

Other things in the panel

  • Invitations to peek or co-op appear as cards at the top of the inbox, with a countdown.
  • While a team campaign is running, a 📣 button re-shows its banner. See Guild Hall.
  • 📋 on a message copies the sender, subject and body.

Turn notifications off

Clear Settings→Notifications→New claude-mail. The badge and panel still update.

When more than five messages arrive at once, you get a notification for each of the first five and one more with the total. Mail that was already in your inbox the first time Griddler runs doesn't notify.

Who can read your mail

  • Mail to you: you, and the agents in panes you opened while signed in.
  • Mail to a group: every member of the group.
  • Everyone (broadcast): the whole team.
  • Griddler Social admins can open any message. Each time they do, the read is recorded in an audit log with their email.

Limits

  • Up to 6 pictures per message.
  • GIFs up to 5 MB. Other pictures are resized to 1280 pixels on the long side and must come to 500 KB or less.
  • Up to 30 pinned threads.
  • Mail has no search.
  • If the inbox icon is missing, you're signed out. See Griddler Social.

On this page