Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
---
title: "Chat"
icon: "comment"
description: "Channels and direct messages are where you, your team, and your customers communicate."
---
Open **Chat** in the sidebar, or press <kbd>g</kbd> \+ <kbd>c</kbd>, to see your channels and direct messages.
Watch a 1:30 walkthrough of Macro Chat.
<video src="https://macro.com/video/tutorials/chat.mp4" poster="https://macro.com/video/tutorials/chat-poster.jpg" controls playsInline preload="metadata" className="w-full aspect-video rounded-xl" />
<div className="chat-preview" role="img" aria-label="Messages in the design channel">
<div className="chat-preview-bar">
<svg width="16" height="16" viewBox="0 0 24 24" fill="none" aria-hidden="true">
<path d="m9 3.5-2 17m10-17-2 17M3.5 8.25h17m-17 7.5h17" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" />
</svg>
<span className="chat-preview-title">design</span>
</div>
<div className="chat-preview-day">Today</div>
<div className="chat-preview-message">
<span className="chat-preview-avatar is-avery">A</span>
<div className="chat-preview-body">
<div className="chat-preview-meta"><span className="chat-preview-name">Avery</span><span className="chat-preview-time">10:24 AM</span></div>
<p>The review notes are in the doc. Can someone take a look?</p>
</div>
</div>
<div className="chat-preview-thread">
<div className="chat-preview-reply">
<span className="chat-preview-avatar is-riley">R</span>
<div className="chat-preview-body">
<div className="chat-preview-meta"><span className="chat-preview-name">Riley</span><span className="chat-preview-time">10:31 AM</span></div>
<p>I'll take the checklist and post it here.</p>
</div>
</div>
<div className="chat-preview-reply">
<span className="chat-preview-avatar is-quinn">Q</span>
<div className="chat-preview-body">
<div className="chat-preview-meta"><span className="chat-preview-name">Quinn</span><span className="chat-preview-time">10:36 AM</span></div>
<p>Let's keep the thread in <span className="chat-preview-channel">#design</span>.</p>
</div>
</div>
<div className="chat-preview-more">
<span className="chat-preview-stack" aria-hidden="true">
<span className="chat-preview-avatar is-avery">A</span>
<span className="chat-preview-avatar is-riley">R</span>
<span className="chat-preview-avatar is-quinn">Q</span>
</span>
<span className="chat-preview-more-count">2 more replies</span>
<span className="chat-preview-more-when">Last reply today</span>
<svg width="14" height="14" viewBox="0 0 24 24" fill="none" aria-hidden="true">
<path d="m9 5 7 7-7 7" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" />
</svg>
</div>
</div>
</div>
Anyone can be added to a channel by entering their email, even if they're not on your team. People without a Macro account receive an email telling them about their channel notifications.
You can have an empty channel with just yourself, or add team members for a collaborative channel.
## Channel types
Macro has two visibility levels for channels:
### Team channels
Team channels are visible to everyone on your [team](/account/teams). Any team member can discover and join them. When you create a team channel, you can enable **Automatically add teammates** to add all current and future team members to the channel.
<Tip>
Use team channels for company-wide announcements, department discussions, or any conversation the whole team should be able to find.
</Tip>
### Private channels
Private channels are only visible to the people you add. They don't appear in search or discovery for non-members. Use private channels for sensitive discussions or conversations with people outside your team.
## Message history
When someone joins a channel, they see the full message history from the beginning — not just messages sent after they joined. This applies to both team and private channels.
## Agents in channels
You can also mention @Macro to call an agent into the channel. @Macro can summarize previous discussions, answer workspace questions, and more.
Mention an agent you created the same way, with its **@tag**. Open **Settings → Agents** and click **Add agent**. A **Private** agent can be mentioned inside of a team channel only by the owner. A **Team** agent can be mentioned by anyone on the team.
In **Settings → Agents**, **Connect Cursor** lets you mention **@Cursor** on your Cursor subscription. **Bring your own agent** pairs Claude Code, Codex, or another local agent through Macrod. See [Bring your own agent](/AI/bring-your-own).
@mention a coding agent in the channel and it opens a session in the thread. When that session opens a pull request, the message links to it.
<div className="agent-preview" role="img" aria-label="Avery mentions Cursor, and the coding session links to a pull request">
<div className="agent-preview-message">
<span className="chat-preview-avatar is-avery">A</span>
<div className="chat-preview-body">
<div className="chat-preview-meta"><span className="chat-preview-name">Avery</span><span className="chat-preview-time">10:41 AM</span></div>
<p><span className="agent-preview-mention">@Cursor</span>, the signup button is too small on mobile. Open a pull request.</p>
</div>
</div>
<div className="agent-preview-response">
<div className="agent-preview-from">from <span className="agent-preview-from-name">Avery</span></div>
<div className="agent-preview-quote"><span className="agent-preview-who">Avery</span><span>@Cursor, the signup button is too small on mobile. Open a pull request.</span></div>
<div className="agent-preview-card">
<div className="agent-preview-card-bar">
<span className="agent-preview-check" aria-hidden="true">
<svg width="12" height="12" viewBox="0 0 24 24" fill="none"><path d="m5 12.25 4.5 4.5L19 7.25" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" /></svg>
</span>
<span className="agent-preview-agent">Cursor Agent</span>
<span className="agent-preview-model">Auto</span>
<span className="agent-preview-status">Done</span>
<span className="agent-preview-open">Open session <svg width="12" height="12" viewBox="0 0 24 24" fill="none" aria-hidden="true"><path d="M7 17 17 7M9 7h8v8" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" /></svg></span>
</div>
<div className="agent-preview-pr">
<svg width="16" height="16" viewBox="0 0 24 24" fill="none" aria-hidden="true">
<path d="M6 2.75a2.25 2.25 0 1 0 0 4.5 2.25 2.25 0 0 0 0-4.5Zm0 14a2.25 2.25 0 1 0 0 4.5 2.25 2.25 0 0 0 0-4.5Zm12 0a2.25 2.25 0 1 0 0 4.5 2.25 2.25 0 0 0 0-4.5Z" fill="currentColor" />
<path d="M6 7.25v9.5M18 16.75V9a4 4 0 0 0-4-4h-3M13.5 2.5 11 5l2.5 2.5" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" />
</svg>
<span className="agent-preview-pr-title">#184 · Fix the mobile signup button</span>
<span className="agent-preview-add">+18</span>
<span className="agent-preview-del">−4</span>
</div>
</div>
</div>
</div>
## Message Features
### Rich Text Editing
Compose messages using Macro's unified rich text editor:
- **Formatting**: Bold, italic, code blocks, lists
- **@mentions**: Reference users, documents, tasks, files, and more
- **Snippets**: Type <kbd>;</kbd> to insert a saved [snippet](/product/snippets)
- **Attachments**: Add files, images, and media
- **Markdown**: Full markdown support for quick formatting
### Message actions
Hover over any message on desktop to reveal its action menu. Alongside reactions and replies, you can:
- **Task** — create a task from the message
- **Chat with Agent** — start an agent chat with the message
- **Copy Link** — copy a link straight to that message so you can paste it into a doc, task, or another channel
- **Copy Text** — copy the message's text to your clipboard
- **Edit** — change a message you sent
- **Delete** — remove a message you sent, or a message from a bot
On mobile, long-press a message to open the same menu. **Task** is **Create task**, and **Chat with Agent** is **Ask Macro**.
### Thread Replies
Keep conversations organized by replying in threads:
1. Click on any message to view or start a thread
2. Thread replies appear indented under the parent message
3. Thread indicators show when new replies are added
<Tip>
Threads help keep channels clean by organizing side conversations and reducing notification noise.
</Tip>
## @Linking System
Mention an entity in a channel and it is shared with the channel participants. The mention also leaves a link you can trace back: the entity shows where it was referenced.
Messages support bidirectional @links to everything in your workspace:
<Steps>
<Step title="Type @">
Start typing `@` to open the mentions menu
</Step>
<Step title="Select an item">
Choose from documents, tasks, emails, files, users, companies, calls or other channels. Mentioning one shares its permissions with the channel participants.
</Step>
<Step title="Create the link">
The mention creates a bidirectional reference you can trace back later
</Step>
</Steps>
### What You Can @Mention
- **Users**: Notify team members (`@username`)
- **Documents**: Reference notes, wikis, and collaborative docs
- **Tasks**: Link to specific tasks or projects
- **Files**: Reference PDFs, images, videos, and other files
- **Emails**: Link to email threads
- **Channels**: Reference other channels or conversations
- **Dates**: Create date references (`@tomorrow`, `@next week`)
- **Groups**: Mention groups like `@here` or `@team`
## Attachments
Share files and media in messages:
- **Drag and drop**: Drop files directly into the message composer
- **File picker**: Browse and select from your storage
- **Inline previews**: Images and supported files show inline previews
<Info>
Attachments shared in channels are automatically imported to Macro's file storage, making them searchable and accessible from anywhere.
</Info>
## Participant Management
Manage channel membership:
- Add or remove participants
- View all channel members
- See participant status and presence
## Best Practices
<Tip>
- Use channels to organize conversations by topic or project
- @mention documents and tasks to create traceable references
- Use threads for side conversations to keep the main channel clean
- React with emoji instead of sending "thanks" messages
- Edit messages to fix mistakes rather than sending corrections
</Tip>