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.

14.0 KB
Raw Blame
---
title: "Tasks"
icon: "square-check"
description: "Track work with priorities, statuses, and linked context."
---

<iframe src="https://www.youtube.com/embed/gxJquVXRX5A" title="YouTube video player" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

Macro Tasks start lightweight enough for a single user but scale easily onto a team, where tasks you create are auto-shared with members. They're @mentionable anywhere in Macro as live, up-to-date pills, sync bidirectionally with GitHub PRs to move status automatically, and are fully accessible to AI clients via Macro's MCP server.

Watch a 1:57 walkthrough of Macro Tasks.

<video src="https://macro.com/video/tutorials/tasks.mp4" poster="https://macro.com/video/tutorials/tasks-poster.jpg" controls playsInline preload="metadata" className="w-full aspect-video rounded-xl" />

<div className="task-list" role="img" aria-label="A task list. Fix the mobile signup button is in review and linked to pull request 184.">
  <div className="task-list-head">
    <span>Task</span>
    <span>Status</span>
    <span>Priority</span>
    <span>Assignees</span>
  </div>
  <div className="task-list-row is-selected">
    <div className="task-list-main">
      <svg className="task-list-mark is-review" width="14" height="14" viewBox="0 0 12 12" aria-hidden="true"><path fill="currentColor" fillRule="evenodd" d="M6 0C9.31 0 12 2.69 12 6C12 9.31 9.31 12 6 12C2.69 12 0 9.31 0 6C0 2.69 2.69 0 6 0ZM6 1.8C8.32 1.8 10.2 3.68 10.2 6C10.2 8.32 8.32 10.2 6 10.2C3.68 10.2 1.8 8.32 1.8 6C1.8 3.68 3.68 1.8 6 1.8Z" /><path fill="currentColor" d="M6 0C2.69 0 0 2.69 0 6C0 9.31 2.69 12 6 12C9.31 12 12 9.31 12 6H6V0Z" /></svg>
      <div className="task-list-copy">
        <span className="task-list-title">Fix the mobile signup button</span>
        <span className="task-list-pr">
          <svg width="12" height="12" 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="task-list-pr-title">Fix the mobile signup button</span>
          <span className="task-list-pr-num">#184</span>
          <span className="task-list-add">+18</span>
          <span className="task-list-del">−4</span>
        </span>
      </div>
    </div>
    <span className="task-list-state"><svg className="is-review" width="12" height="12" viewBox="0 0 12 12" aria-hidden="true"><path fill="currentColor" fillRule="evenodd" d="M6 0C9.31 0 12 2.69 12 6C12 9.31 9.31 12 6 12C2.69 12 0 9.31 0 6C0 2.69 2.69 0 6 0ZM6 1.8C8.32 1.8 10.2 3.68 10.2 6C10.2 8.32 8.32 10.2 6 10.2C3.68 10.2 1.8 8.32 1.8 6C1.8 3.68 3.68 1.8 6 1.8Z" /><path fill="currentColor" d="M6 0C2.69 0 0 2.69 0 6C0 9.31 2.69 12 6 12C9.31 12 12 9.31 12 6H6V0Z" /></svg>In Review</span>
    <span className="task-list-priority"><span className="task-list-bars is-high" aria-hidden="true"><span /><span /><span /></span>High</span>
    <span className="task-list-who is-avery">A</span>
  </div>
  <div className="task-list-row">
    <div className="task-list-main">
      <svg className="task-list-mark is-progress" width="14" height="14" viewBox="0 0 12 12" aria-hidden="true"><path fill="currentColor" fillRule="evenodd" d="M6 0C9.31 0 12 2.69 12 6C12 9.31 9.31 12 6 12C2.69 12 0 9.31 0 6C0 2.69 2.69 0 6 0ZM6 1.8C8.32 1.8 10.2 3.68 10.2 6C10.2 8.32 8.32 10.2 6 10.2C3.68 10.2 1.8 8.32 1.8 6C1.8 3.68 3.68 1.8 6 1.8Z" /><path fill="currentColor" d="M6 0C2.69 0 0 2.69 0 6C0 9.31 2.69 12 6 12V0Z" /></svg>
      <span className="task-list-title">Confirm the March invoice</span>
    </div>
    <span className="task-list-state"><svg className="is-progress" width="12" height="12" viewBox="0 0 12 12" aria-hidden="true"><path fill="currentColor" fillRule="evenodd" d="M6 0C9.31 0 12 2.69 12 6C12 9.31 9.31 12 6 12C2.69 12 0 9.31 0 6C0 2.69 2.69 0 6 0ZM6 1.8C8.32 1.8 10.2 3.68 10.2 6C10.2 8.32 8.32 10.2 6 10.2C3.68 10.2 1.8 8.32 1.8 6C1.8 3.68 3.68 1.8 6 1.8Z" /><path fill="currentColor" d="M6 0C2.69 0 0 2.69 0 6C0 9.31 2.69 12 6 12V0Z" /></svg>In Progress</span>
    <span className="task-list-priority"><span className="task-list-bars is-medium" aria-hidden="true"><span /><span /><span /></span>Medium</span>
    <span className="task-list-who is-riley">R</span>
  </div>
  <div className="task-list-row">
    <div className="task-list-main">
      <svg className="task-list-mark is-todo" width="14" height="14" viewBox="0 0 12 12" aria-hidden="true"><path fill="currentColor" fillRule="evenodd" d="M6 0C9.31 0 12 2.69 12 6C12 9.31 9.31 12 6 12C2.69 12 0 9.31 0 6C0 2.69 2.69 0 6 0ZM6 1.8C8.32 1.8 10.2 3.68 10.2 6C10.2 8.32 8.32 10.2 6 10.2C3.68 10.2 1.8 8.32 1.8 6C1.8 3.68 3.68 1.8 6 1.8Z" /></svg>
      <span className="task-list-title">Book the loading dock</span>
    </div>
    <span className="task-list-state"><svg className="is-todo" width="12" height="12" viewBox="0 0 12 12" aria-hidden="true"><path fill="currentColor" fillRule="evenodd" d="M6 0C9.31 0 12 2.69 12 6C12 9.31 9.31 12 6 12C2.69 12 0 9.31 0 6C0 2.69 2.69 0 6 0ZM6 1.8C8.32 1.8 10.2 3.68 10.2 6C10.2 8.32 8.32 10.2 6 10.2C3.68 10.2 1.8 8.32 1.8 6C1.8 3.68 3.68 1.8 6 1.8Z" /></svg>Not Started</span>
    <span className="task-list-priority"><span className="task-list-bars is-low" aria-hidden="true"><span /><span /><span /></span>Low</span>
    <span className="task-list-who is-quinn">Q</span>
  </div>
  <div className="task-list-row">
    <div className="task-list-main">
      <svg className="task-list-mark is-todo" width="14" height="14" viewBox="0 0 12 12" aria-hidden="true"><path fill="currentColor" fillRule="evenodd" d="M6 0C9.31 0 12 2.69 12 6C12 9.31 9.31 12 6 12C2.69 12 0 9.31 0 6C0 2.69 2.69 0 6 0ZM6 1.8C8.32 1.8 10.2 3.68 10.2 6C10.2 8.32 8.32 10.2 6 10.2C3.68 10.2 1.8 8.32 1.8 6C1.8 3.68 3.68 1.8 6 1.8Z" /></svg>
      <span className="task-list-title">Write the interview guide</span>
    </div>
    <span className="task-list-state"><svg className="is-todo" width="12" height="12" viewBox="0 0 12 12" aria-hidden="true"><path fill="currentColor" fillRule="evenodd" d="M6 0C9.31 0 12 2.69 12 6C12 9.31 9.31 12 6 12C2.69 12 0 9.31 0 6C0 2.69 2.69 0 6 0ZM6 1.8C8.32 1.8 10.2 3.68 10.2 6C10.2 8.32 8.32 10.2 6 10.2C3.68 10.2 1.8 8.32 1.8 6C1.8 3.68 3.68 1.8 6 1.8Z" /></svg>Not Started</span>
    <span className="task-list-priority"><span className="task-list-bars is-medium" aria-hidden="true"><span /><span /><span /></span>Medium</span>
    <span className="task-list-who is-avery">A</span>
  </div>
  <div className="task-list-row">
    <div className="task-list-main">
      <svg className="task-list-mark is-done" width="14" height="14" viewBox="0 0 12 12" aria-hidden="true"><path fill="currentColor" fillRule="evenodd" d="M6 0C9.31 0 12 2.69 12 6C12 9.31 9.31 12 6 12C2.69 12 0 9.31 0 6C0 2.69 2.69 0 6 0ZM9.34 3.86C9.5 4.03 9.6 4.26 9.6 4.5C9.6 4.74 9.5 4.97 9.34 5.14L5.74 8.74C5.57 8.9 5.34 9 5.1 9C4.86 9 4.63 8.9 4.46 8.74L2.66 6.94C2.32 6.59 2.32 6.01 2.66 5.66C3.01 5.32 3.59 5.32 3.94 5.66L5.1 6.83L8.06 3.86C8.41 3.52 8.99 3.52 9.34 3.86Z" /></svg>
      <span className="task-list-title">Send the office notice</span>
    </div>
    <span className="task-list-state"><svg className="is-done" width="12" height="12" viewBox="0 0 12 12" aria-hidden="true"><path fill="currentColor" fillRule="evenodd" d="M6 0C9.31 0 12 2.69 12 6C12 9.31 9.31 12 6 12C2.69 12 0 9.31 0 6C0 2.69 2.69 0 6 0ZM9.34 3.86C9.5 4.03 9.6 4.26 9.6 4.5C9.6 4.74 9.5 4.97 9.34 5.14L5.74 8.74C5.57 8.9 5.34 9 5.1 9C4.86 9 4.63 8.9 4.46 8.74L2.66 6.94C2.32 6.59 2.32 6.01 2.66 5.66C3.01 5.32 3.59 5.32 3.94 5.66L5.1 6.83L8.06 3.86C8.41 3.52 8.99 3.52 9.34 3.86Z" /></svg>Completed</span>
    <span className="task-list-priority"><span className="task-list-bars is-low" aria-hidden="true"><span /><span /><span /></span>Low</span>
    <span className="task-list-who is-quinn">Q</span>
  </div>
</div>

### Task Statuses

Tasks come with a small set of properties: **Status**, **Priority**, and **Assignees**. Add your own with **Add property**.

<div style={{ display: 'flex', flexDirection: 'column', gap: '0.75rem', paddingLeft: '1.625rem', margin: '1rem 0' }}>
  <div style={{ display: 'flex', alignItems: 'center', gap: '0.625rem' }}><svg width="14" height="14" viewBox="0 0 12 12" fill="#9ca3af" xmlns="http://www.w3.org/2000/svg"><path fillRule="evenodd" clipRule="evenodd" d="M6 0C9.31 0 12 2.69 12 6C12 9.31 9.31 12 6 12C2.69 12 0 9.31 0 6C0 2.69 2.69 0 6 0ZM6 1.8C8.32 1.8 10.2 3.68 10.2 6C10.2 8.32 8.32 10.2 6 10.2C3.68 10.2 1.8 8.32 1.8 6C1.8 3.68 3.68 1.8 6 1.8Z" /></svg> <span><strong>Not Started</strong> — the task hasn't been picked up yet</span></div>

  <div style={{ display: 'flex', alignItems: 'center', gap: '0.625rem' }}><svg width="14" height="14" viewBox="0 0 12 12" fill="#fbbf24" xmlns="http://www.w3.org/2000/svg"><path fillRule="evenodd" clipRule="evenodd" d="M6 0C9.31 0 12 2.69 12 6C12 9.31 9.31 12 6 12C2.69 12 0 9.31 0 6C0 2.69 2.69 0 6 0ZM6 1.8C8.32 1.8 10.2 3.68 10.2 6C10.2 8.32 8.32 10.2 6 10.2C3.68 10.2 1.8 8.32 1.8 6C1.8 3.68 3.68 1.8 6 1.8Z" /><path d="M6 0C2.69 0 0 2.69 0 6C0 9.31 2.69 12 6 12V0Z" /></svg> <span><strong>In Progress</strong> — someone is actively working on it</span></div>

  <div style={{ display: 'flex', alignItems: 'center', gap: '0.625rem' }}><svg width="14" height="14" viewBox="0 0 12 12" fill="#a78bfa" xmlns="http://www.w3.org/2000/svg"><path fillRule="evenodd" clipRule="evenodd" d="M6 0C9.31 0 12 2.69 12 6C12 9.31 9.31 12 6 12C2.69 12 0 9.31 0 6C0 2.69 2.69 0 6 0ZM6 1.8C8.32 1.8 10.2 3.68 10.2 6C10.2 8.32 8.32 10.2 6 10.2C3.68 10.2 1.8 8.32 1.8 6C1.8 3.68 3.68 1.8 6 1.8Z" /><path d="M6 0C2.69 0 0 2.69 0 6C0 9.31 2.69 12 6 12C9.31 12 12 9.31 12 6H6V0Z" /></svg> <span><strong>In Review</strong> — the work is done and awaiting review</span></div>

  <div style={{ display: 'flex', alignItems: 'center', gap: '0.625rem' }}><svg width="14" height="14" viewBox="0 0 12 12" fill="#4ade80" xmlns="http://www.w3.org/2000/svg"><path fillRule="evenodd" clipRule="evenodd" d="M6 0C9.31 0 12 2.69 12 6C12 9.31 9.31 12 6 12C2.69 12 0 9.31 0 6C0 2.69 2.69 0 6 0ZM9.34 3.86C9.5 4.03 9.6 4.26 9.6 4.5C9.6 4.74 9.5 4.97 9.34 5.14L5.74 8.74C5.57 8.9 5.34 9 5.1 9C4.86 9 4.63 8.9 4.46 8.74L2.66 6.94C2.32 6.59 2.32 6.01 2.66 5.66C3.01 5.32 3.59 5.32 3.94 5.66L5.1 6.83L8.06 3.86C8.41 3.52 8.99 3.52 9.34 3.86Z" /></svg> <span><strong>Completed</strong> — the task is finished</span></div>

  <div style={{ display: 'flex', alignItems: 'center', gap: '0.625rem' }}><svg width="14" height="14" viewBox="0 0 12 12" fill="#9ca3af" xmlns="http://www.w3.org/2000/svg"><path fillRule="evenodd" clipRule="evenodd" d="M6 0C9.31 0 12 2.69 12 6C12 9.31 9.31 12 6 12C2.69 12 0 9.31 0 6C0 2.69 2.69 0 6 0ZM3.36 3.36C3.71 3.01 4.28 3.01 4.63 3.36L6 4.73L7.37 3.36C7.72 3.01 8.29 3.01 8.64 3.36C8.99 3.71 8.99 4.28 8.64 4.63L7.27 6L8.64 7.37C8.99 7.72 8.99 8.29 8.64 8.64C8.29 8.99 7.72 8.99 7.37 8.64L6 7.27L4.63 8.64C4.28 8.99 3.71 8.99 3.36 8.64C3.01 8.29 3.01 7.72 3.36 7.37L4.73 6L3.36 4.63C3.01 4.28 3.01 3.71 3.36 3.36Z" /></svg> <span><strong>Canceled</strong> — the task won't be done</span></div>
</div>

You can reference a task in your channels, in your documents, or with an agent by @mentioning it. Quickly create a task directly from a channel or an email by hovering and selecting the task button.

You can manually review all of your team's tasks in the task view or ask your agent to give you updates on them.

### Assigning agents

Each [agent](/product/agents) you assign to a task starts a session. The task's discussion gets a message that links to it, and the work stays in that session. People and agents can be assigned to the same task. Remove an agent and assign it again to start a new session.

Assign an agent to a project and it starts a session for each task added to that project afterward. Tasks already in the project are not started. Removing the agent stops that for tasks added later. Sessions already running keep going.

### Team level sharing

When you're on a team, a new task is shared with its members unless you turn that off. The switch is labeled **Share with** and your team name, and it starts on. Turn it off and only you and the people you share it with can see the task. Teammates who can see it can view and comment, while you (and the assignee) keep full control over its status and properties. Assigning a task to someone sends them an inbox notification, as does @mentioning a teammate in the task's comments.

**Sharing follows team membership**

- Join a team and you'll see the tasks shared with it, those assigned to you and to others.
- If you're removed from the team, you lose access to them.
- If you're not on a team, your tasks stay private to you.

### GitHub integration

Macro tasks integrate with GitHub: as you create, review, and merge branches, the task automatically moves to "In Progress," "In Review," or "Completed," and the task records which pull request is associated with it. See [GitHub integration](/integrations/github) for setup and details.

### MCP setup

Macro's MCP server lets AI clients like Claude Code, Codex, and Cursor work with your tasks directly. Connect once by going to **Settings → MCP server** (authorize with your Macro account — MCP access is included on every plan, Free included). You can use the MCP server to spin up a task, triage your list, or move something to "In Review" without leaving your editor. Any changes made will show up live in Macro.

**MCP for tasks uses**

- **Create a task**
- **Find your tasks**
- **Read a task**
- **Update a task**

### @mentioning

Tasks are markdown entities, so you can @mention one anywhere else in Macro — in a doc, an email, a chat, a channel, or another task. The mention renders as a live pill that stays in sync with the task's status and title, so wherever you reference it, you're always looking at the current state. Click it to jump straight to the task.