Skip to content

armgit / macro

Public Imported from GitHub
0

Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.

10.6 KB
Raw Blame
---
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>